#Run Migrations

When your device mappings within a migration project are ready for migrations, you can run migrations for the mappings to migrate permissions or rejoin domain.

Refer to the following steps to run migrations for mappings:

1. Click Projects in the left pane to access the Projects page, and click the project name of the project you want to run.

2. On the Project mappings page, select one or multiple mappings for which you want to run migrations.

   NOTE

   To ensure the migration performance, we do not recommend you select more than 5000 mappings at a time to run migrations.

3. Click Migration, you can select to run the following jobs for the mappings:

   • Rejoin domain – Rejoin the source device to the new domain. The Default App configuration and the permissions of source devices will be automatically migrated in the migration.

     The rejoin method depends on your configuration of destination connection of the current project. You can refer to Create a Migration Policy for details.

     NOTE

     Before the migration begins, ensure that all open documents are saved and all applications are closed to prevent data loss. Once the migration starts, your computer screen will be locked. Please keep your device awake and do not attempt to log in while the migration is in progress. The device will restart automatically after the migration is complete. Forcing an early login may result in lost changes or disrupt the migration process.

   • Migrate permissions – Migrate permissions of source device areas to the destination.

     Note that the permission migration requires the device to have rejoined the domain first.

   • Migrate Windows user profile – Migrate desktop configurations and permissions under the user's local Windows user profile (C:\Users\username). This ensures the user retains access to personal data and settings, including desktop, documents, app data, and personalized operating system settings.

   • Migrate Entra ID groups – Migrate the Microsoft Entra ID group memberships associated with the device from the source tenant to the destination tenant. To ensure a successful migration, the source Microsoft Entra ID connection must be enabled first. Refer to Create a Connection for details.

   • Register Windows Autopilot – Register the devices with Windows Autopilot in the destination tenant to set up and pre-configure devices, getting them ready for productive use. Note that Windows Autopilot registration is supported only when rejoining the Microsoft Entra ID domain offline.

4. Click OK in the pop-up window to run the migration immediately.