UiPath Documentation
automation-suite
2.2510
true
UiPath logo, featuring letters U and I in white

Automation Suite on Linux installation guide

Last updated Mar 26, 2026

Performing a single tenant migration

You can use the UiPath Automation Cloud™ Migration Tool to automatically migrate entities from your standalone Orchestrator to the Orchestrator service in Automation Suite.

This page provides details on the type of entities being migrated, the requirements for the migration from standalone Orchestrator to Automation Suite, the specific migration procedure, and any operations that may be necessary after the migration.

Before you begin​

When planning your migration from on-premises Orchestrator to Automation Suite, it is advisable that you take the following steps:

  1. Upgrade to a supported on-premises Orchestrator version.
  2. Migrate from classic to modern folders, as classic folders have restrictions in Automation Suite.
  3. Run the migration tool to migrate from on-premises Orchestrator to Automation Suite.

Entities being migrated​

When you run the Automation Cloud Migration Tool, it automatically creates the following entities in Automation Suite to match your standalone Orchestrator setup:

Entity

Migrated

Not Migrated

Settings

Yes, with exceptions (see on the right).

Some settings that are exposed to the tenant on the read path cannot be modified in Automation Suite, like host logo and color.

Passwords in the Settings table cannot be exported because the API removes the values from the response. As a result no passwords will be migrated. This affects email alerts (SMTP password) and external feeds with basic authentication.

Packages

Migrates all packages and all package versions.

If a package feed is external and configured with basic authentication, the credentials will need to be input after the migration completes.

If a package feed is external and not accessible over the internet, entities that rely on these packages are not migrated.

Libraries

Tenant-level feeds only.

If a library feed is at the host level or is external and not accessible over the internet, entities that rely on these libraries are not migrated.

Calendars

Yes

N/A

Machines

Yes, but if there are not enough licenses to accommodate Machine slot assignments, the Machine will be imported with all slots set to 0.

Machine keys are not migrated.

Folders

 Yes

You can choose to migrate all folders in bulk, as well as individual folders.

Personal workspace folders are not migrated.

Environments

Yes, for classic folders.

N/A for modern folders.

Robots (classic)

Yes, but if there are not enough licenses to accommodate robot creation, the robot is skipped during import.

Skipped when licenses run out and an error is logged for each.

Robots (modern)

Modern robots are migrated if the user with which they are associated exists in Automation Suite and has the same email address.

  • If the user doesn’t exist in Automation Suite, that specific robot migration fails.
  • Skipped when licenses run out and an error is logged for each.

Environment associations

The robot-environment mapping is migrated.

N/A

Processes

Processes are migrated. The tool may refer to these as Releases.

N/A

Queues

Yes

N/A

Triggers

Triggers are migrated, but are all set as disabled.

 

Assets
  • Boolean, Text, and Integer asset types are fully supported.
  • Credential assets are also migrated, but a dummy password is used because passwords cannot be migrated by the tool. You will need to manually update the passwords for each credential asset after migration. Credential assets are assigned to the default credential store in Automation Suite.
  • Per-robot values are also migrated, but if the robot wasn’t migrated, this value is skipped and an import warning is logged.

Per-user asset values in modern folders are not supported. The asset is imported with the default value or skipped if none is set.

Machine associations

Robot-machine mappings are migrated.

N/A

Entities not migrated​

The following entities are not migrated by the tool:

  • Folder feeds
  • Users
  • Queue items
  • Action catalogs
  • Webhooks
  • Testing entities (test sets, test cases, test executions, test schedules, test data queues)
  • Logs

Prerequisites​

Before opening the tool, make the following preparations:

  1. Make sure you have sufficient robot licenses in Automation Suite to match the number of robots being migrated (Admin > Licenses > Robots & Services). The tool only migrates robots as long as there are licenses available, after which it starts to skip robots.

  2. You must have administrator credentials for the standalone Orchestrator and View permissions for all entities being migrated. If you don't have the View permission for some entities, those entities are not migrated.

  3. You must be an organization administrator in Automation Suite.

  4. To run the tool, you need a machine that:

    1. can connect to the standalone Orchestrator and to Automation Suite (has internet access)
    2. has the Windows operating system

  5. Download the tool on the mentioned machine from this link.

  6. Register the tool as an external application in the target Automation Suite organization.

Registering the tool as an external application​

The migration tool needs to connect to the Orchestrator service API in Automation Suite to create the migrated entities. It uses the OAuth flow for this and therefore must be registered in Automation Suite as an external application.

  1. Follow these instructions to add the tool as a new external application with the following specifics:

    • Type: Non-confidential
    • Resources: Orchestrator API
    • User scopes: OR.Folders, OR.Settings, OR.Robots, OR.Machines, OR.Execution, OR.Assets, OR.Users, OR.Jobs, and OR.Queues.
    • Redirect URL: http://127.0.0.1:8888/auth/

  2. Save the Application ID for later use.

Running the tool​

The tool can migrate one tenant at a time. You can run the tool multiple times for each of your tenants.

With each run, the tool:

  1. Connects to your standalone Orchestrator to export entities for the given tenant.
  2. Connects to Automation Suite to import and create the migrated entities in the Orchestrator tenant.

For more information about entities that are subject to migration, see Entities Being Migrated.

To run the tool:

  1. Extract the ZIP file you downloaded for the tool and then run the tool EXE.

  2. For the activation method, choose Connect to On-Premises:

    migration tool step 2

  3. Fill in the information to allow the tool to connect to your standalone Orchestrator:

    migration tool step 3

    Make sure that the credentials you provide are for an administrator account that also has View permissions on all the entities you want to migrate.

  4. Select Start Export to connect to your standalone Orchestrator and download the setup information.The export begins and may take a while to complete:

    docs image

    When finished, the export summary lists all entities that were successfully exported:

    docs image

    You can select Open File to view the local file created for the export summary, which includes a few more details.

  5. Select Home to return to the first screen.

  6. For the activation method, this time choose Connect to Automation Suite.

  7. Fill in the information to allow the tool to connect to Automation Suite to upload the setup information:

    migration tool step 7

    FieldDetails
    Organization URLThe URL of your Automation Suite organization. Organization administrators can find the organization name under Admin > Organization Settings. For example, enter https://mySite.com/myOrgName.
    Application IdThe Application ID value associated with the external application registration in Automation Suite. You can find this value on the Admin > External Applications page.
    Tenant NameThe exact name of the Automation Suite tenant where you want to add the migrated information. The migrated data will be visible in the specified Orchestrator tenant.
    Identity URL (optional)The identity endpoint URL for your Automation Suite organization. For example, enter https://mySite.com/myOrgName/identity_.

  8. Select Start Import to connect to Automation Suite and start to migrate the information to the target Orchestrator tenant.

    The import begins and may take a while to complete:

    docs image

    To connect to Automation Suite using OAuth, a user with the adequate permissions for the scopes added when you registered the external application must log in to Automation Suite. When they do, a new window opens with a success message if the OAuth flow was successful:

    docs image

    When finished, the import summary lists all entities that were successfully imported into the Orchestrator tenant in Automation Suite:

    docs image

    Anything that was not imported is listed as an error and partial imports are listed as warnings. You can select View Report for more details about exactly which entities encountered an error or warning.

  9. When ready, select Done to close the tool.

    Tip:

    If needed, you can run the tool again to migrate data for additional tenants.

Post-migration tasks​

Because the tool cannot migrate everything, there are some final tasks that you must perform manually to obtain the same setup as you had in your standalone Orchestrator.

  1. In Automation Suite, log in to the organization of the tenant that was the import target and then open Orchestrator.

  2. Check that folders and entities were successfully migrated.

    You can use the import summary to check the specific items that had warnings or errors.

  3. Allocate robot and service licenses for Orchestrator.

    During import, machines are created and licensed while available licenses exist. After licenses run out, machines continue to be created without licenses, so you must update any such machines to allocate the adequate number of licenses.

    Note:

    If you migrated without activating your Automation Suite license, at this stage you need to activate it to continue with the setup.

  4. Manually upload any library feeds that the tool did not migrate.

  5. If any robots were skipped during export or import, manually create them.

  6. Create any webhooks, task catalogs, credential stores, or other information that the tool does not migrate.

    The section Entities being migrated includes a list of what the tool does not migrate.

  7. Manually connect robots to the Automation Suite Orchestrator service.

  8. Manually enable triggers as needed.

    While the tool migrates triggers, they are all disabled and you must manually enable them.

  9. Check any locations in Orchestrator where a password is required and add it: Robots, Settings, and Credential Assets.

Getting help​

If you need assistance with an issue encountered during export, import, or after import, open a Support ticket and include the following files:

  • Log file (in the logs sub-folder)
  • Export report file (in the MigrationAssets sub-folder)
  • Import report file (in the MigrationAssets sub-folder)

In addition to these files, it would be helpful to know:

  • The version of your standalone Orchestrator
  • Your Automation Suite organization and tenant names.

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated