orchestrator
2022.4
false
UiPath logo, featuring letters U and I in white

Orchestrator user guide

Last updated Apr 22, 2025

Managing your host license

Managing Host Licenses in an Online Instance

If your instance of Orchestrator has access to the internet, follow the instructions in this section to activate, update, or deactivate your host license.

Activating Your License Online

  1. Log in to the host portal as a system administrator and navigate to the Licenses page.
  2. Click Activate License and select Online Activation.

    The Activate License Online panel opens from the right of the window.

    The Account ID field is automatically populated with the unique identifier of your Orchestrator instance.

  3. In the License Code field, enter the license key you received from UiPath.
  4. Click Activate.

Updating Your License Online

Whenever your license changes - for example when new licenses are added, or when you renew your license - you must perform a license update from Orchestrator.

  1. Log in to the host portal as a system administrator and navigate to the Licenses page.
  2. Click Update License in the top right and select Online Activation.

    The Update License Online panel opens from the right of the window and the Account ID and License Code fields are already filled in with your information.

  3. Click Update.

Orchestrator automatically checks your license status and synchronizes any changes. When finished, a success message appears in a tooltip at the top right of the page and the Licenses page refreshes to display the updated information.

Deactivating Your License Online

  1. Log in to the host portal as a system administrator and navigate to the Licenses page.
  2. In the top right, click Remove and select Online Deactivation.
    Note: If Orchestrator cannot access the internet, the offline deactivation option is triggered.
  3. In the confirmation dialog, click Deactivate to confirm the action.

A tooltip appears in the top right of the screen, confirming that the license has been deactivated.

On the Licenses page, the state changes to Unlicensed.

Managing Host Licenses in an Offline Instance

If your instance of Orchestrator does not access to the internet, follow the instructions in this section to activate, update, or deactivate your host license.

Activating Your License Offline

Step 1. Obtaining the License Request File

  1. Log in to the host portal as a system administrator and navigate to the Licenses page.
  2. Click Activate License and then select Offline Activation.

    The Activate License Offline panel opens at the right of the window.

  3. Fill in the License Code field with your license key.
  4. Under Do you have a license file? select No.
    Note: If you already have a license file, skip to the sub-section Activating the license.
  5. Under step 1, click Download to generate and save a license request file. A download begins for the file Activation Request.txt.
  6. Move this file to a different machine which does have internet access.

Step 2. Obtaining the License File

Follow these instructions on a machine with internet access.

  1. Copy the license request file Activation Request.txt to the machine.
  2. In a web browser, go to the Activation Portal.
  3. In the bottom right, select Upload from File and choose the Activation Request.txt file to upload it.

    The file contents is added to the text box.

  4. Select Generate License File.

    A download begins for the file license.txt.

  5. Transfer the file license.txt back to the Orchestrator machine.

Step 3. Activating the License

  1. Log in to the host portal as a system administrator and navigate to the Licenses page.
  2. Click Activate License and then select Offline Activation.

    The Activate License Offline panel opens at the right of the window.

  3. Fill in the License Code field with your license key.
  4. Under Do you have a license file? select Yes.
  5. Under Upload License, click Choose File and select the license.txt file.
  6. Click Activate.

Your Orchestrator instance now appears as licensed and the Licenses page shows your available licenses.

Updating Your License Offline

Whenever your license changes - for example when new licenses are added, or when you renew your license - you must perform a license update from Orchestrator.

If your instance of Orchestrator does not have access to the internet, the process for updating the license is the same as the one for activating the license offline.

Deactivating Your License Offline

Step 1. Obtaining the License Deactivation File

  1. Log in to the host portal as a system administrator and navigate to the Licenses page.
  2. Click Remove and then select Offline Deactivation.

    The Deactivate License panel opens at the right of the window.

  3. Under step 1, click Download to generate and save a license deactivation file.

    A download begins for the file Deactivation Request.txt.

  4. Move this file to a different machine which does have internet access.

Step 2. Deactivating the License

Follow these instructions on a machine with internet access.

  1. Copy the file Deactivation Request.txt to the machine.
  2. In a web browser, go to the Activation Portal.
  3. Select the Deactivate your License tab.
  4. In the bottom right, select Upload from File and choose the Deactivation Request.txt file to upload it.

    The file contents is added to the text box.

  5. Select Generate License File.

Was this page helpful?

Support and Services
Get The Help You Need
UiPath Academy
Learning RPA - Automation Courses
UiPath Forum
UiPath Community Forum
Uipath Logo
Trust and Security
Terms of Use
Privacy Policy
Cookies Policy
© 2005-2025 UiPath. All rights reserved.