UiPath Orchestrator Guide

The Windows Installer


Before performing this procedure, ensure that you went through the Prerequisites chapter, and have made all the necessary preparations.

  1. Run the Windows Installer (UiPathPlatform.msi). The UiPath Platform Setup wizard is displayed.
  2. Read and accept the terms, and click Advanced. The Product Features step is displayed.
  3. Select the Orchestrator WebSite > Will be installed on local hard drive to install it.
  1. (Optionally) Select the Robot and Studio features.
  2. Click Next. The Orchestrator IIS Settings step is displayed.
  1. Change the IIS Settings as desired:
    • Website name - the name of the website. This is set to UiPathOrchestrator2018.1 and cannot be edited.
    • Host name - used to identify the device on which Orchestrator is installed. By default, this is set to the full computer name.
    • Website Port - the port you want to use to enable the communication between the computer and Orchestrator. By default, this is 443, to enable you to use HTTPS.
    • Add firewall rules for this port - when selected, automatically adds firewall rules for this port, to ensure your machine's security.
    • SSL certificate - the name of the SSL certificate you want to use to secure connections with Orchestrator. By default, this is filled in with the full computer name.
  2. Click Next. The Application Pool Settings step is displayed.
  1. Configure the following options as desired:
    • AppPool name - the application pool name. This is set to UiPathOrchestrator2017.1 by defautl and cannot be edited.
    • Identity for AppPool - enables you to chose between running the UiPath Orchestrator website under an application pool identity or a specified Windows identity.
      • Application Pool Identity - runs the Orchestrator website under the identity of an application pool.
      • Custom account - runs the Orchestrator website under a specified Windows identity. Selecting this option displays two fields, User name and Password, which enable you to specify the Windows identity under which to run.

For more information on the differences between the two, please see Microsoft's official documentation - https://technet.microsoft.com/en-us/library/cc771170(v=ws.10).aspx.

  1. Click Next. The Orchestrator Database Settings step is displayed.
  1. Fill in the fields with information about your SQL Server, as follows:


If you want to migrate your data from the 2017.1 version, provide the information of the v2017.1 SQL Server database.

  • SQL Server Host - the name of the SQL Server machine. By default, this is set to localhost (.). If it is not the default instance, please also mention it in the MyMachine\MyInstance format. You can also specify a custom port number here using a comma, such as MyMachine\MyInstance,800.
  • Database Name - the name of the database. By default, it is UiPath.
  • Authentication mode - chose one of the following:
    • Windows Integrated Authentication - If you select this option, Orchestrator connects to the database using the detected IIS Application Pool's Windows account, or creates the database using the Windows credentials you are currently logged in with. For more information, see the Prerequisites chapter.
    • SQL Server Authentication - This is the default option. When you select this, the SQL Username and Password fields are displayed, that have to be filled in with the SQL Server username and password. For more information, see the Prerequisites chapter.
  1. Click Next. The SQL connection is verified by the installer. If the SQL connection was not valid, a dialog box is displayed. If the SQL connection was valid, the next step is displayed. The Elasticsearch Log Settings step is displayed.
  1. (Optional) Fill in the fields with information about your Elasticsearch instance, as follows:
    • URL - The Elasticsearch URL to which you want to log information.
    • Requires authentication - Enables you to indicate if your Elasticsearch instance requires authentication. If selected, the Username and Password.
      • Username - The Elasticsearch username.
      • Password - The Elasticsearch password.


If you do not want to use Elasticsearch for logging, please leave the URL field empty.

  1. Click Next. The Orchestrator Authentication Settings step is displayed.
  1. Fill in the fields as follows:
    • Enable Windows Authentication - If selected, enables Windows Authentication in Orchestrator and displays the Active Directory domain field.
      • Active Directory domain - the Active Directory domain you want to use in Orchestrator and from which users are going to be imported from.
  2. Click Next. The Ready to install UiPath step is displayed.
  3. Click Install. The installation process starts. Note that Orchestrator is installed at the following location: C:\Program Files (x86)\UiPath\Orchestrator.
  4. Navigate to IIS Manager.
  5. Select the server. The Features View is updated accordingly.
  6. Double-click Feature Delegation. The Feature Delegation view is displayed.
  7. Right-click the Authentication - Windows and click Read/Write.
  8. Start the website. You can now use Orchestrator.

The Windows Installer