1.Cross Tenant Laptop Migration : Introduction

2.How does it work?

A local agent needs to be installed on every laptop.

Once installed, the migration can be centrally managed from the Cloudiway console. The administror will trigger or schedule the migration.

The agent will periodically connect to the Cloudiway platform and determine if it’s time to migrate. If so, the migration of the laptop will take place.

3. Cross Tenant Laptop Migration Setup

You need :

  • To configure the Cloudiway platform
    • To configure the credentials
    • To configure the global settings
    • To configure the user list
  • To deploy the agent

The first thing to configure is the credentials that will be used by the local agents to connect to the Cloudiway platform.

For this, login to your primary account and enter your Cloudiway project that will hold your configuration.

Then, in the upper right, click on your Account Name, then Apis.

In the Personal Access token section, Click on New Token and create a Personal access token. This will be the credentials used by the local agents to authenticate to Cloudiway.
  • Give it a name (for example Intune Migration)
  • Select your project
  • Give it an expiration date
  • Enable Agent Tenant Migration

Click on Create and store the personal access token value for later use.

Cross tenant laptop migration between microsoft 365 tenants : PAT

3.2 Global Settings

Navigate to Cross Tenant Migration / Local Agent.

Click on Global Settings.

Company Key: is automatically generated by the platform. It is your unique indentifier that deployed agents will use to lookup their configuration.

Agent Version: Enable or disable Automatic Upgrade.

Global Settings: Enable or disable the tasks that you want to be performed on the local computers.

Navigate to Cross Tenant Migration / Laptop Migration / User List

From the Menu, click on Migration /Get List.

This will discover your list of users and populate the migration list.

You have 2 choices for deploying the local agent.

  1. You can deploy it using your internal software deployment solution, for instance deployment through Intune or Active Directory GPO.
  2. You can use the Cloudiway Platform to deploy the agent.
    1. Send an installation link to your users.
    2. The users will receive an installation link by mail and they will install themself the agent.
    3. The agent will enter in automatic execution (Shortcut in startup program)

When the user clicks on the link, he is redirected to the following page:

Installation is done through click Once. The link received by the user forces the execution through Microsoft Edge because not all browsers support Click Once by default and Microsoft Edge does.

Once the installation is complete, it runs automatically in the background and it is accessible in  the systray of the computer.

Once your userlist is populated and your agents are deployed, you can trigger the migration of the laptop.

From the userlist, select your users and click On Migration / Start

Schedule the migration at the time of your choice or trigger it immediately.

You can monitor your migration progress from the Agent Device List.

Device List

From here you can get the status of migration of each computer, restart or stop them.

If you click on a Computer, you’ll get access to the migration logs.

You can get access to the same information from the User List. 

If you click on the number of computers, it opens the list of computers for the selected users, and from here you can start/stop the migration of a computer and access the migration logs.

4. Azure AD Registered Devices migration: What is done exactly?

Azure AD Registered :

It deletes the registry keys that are storing the information about AD registrations

Office licenses:

The agent implements the following steps to reinitialize the Office licenses.

OneDrive Synchronization Agent:

The agent implements the following steps: Reset the OneDrive Sync Client

Outlook Profile

The outlook profile is deleted. After migration, end users can create a new outlook profile. It is very straightforwared and requires only 3 steps documented here:


Cloudiway provides an extensive knowledge base with many resources, including common error messages, video guides, and downloads.

Please visit the knowledgebase here: 

9.1 Support

Support tickets are opened through the platform.

Once logged in, go to your project and select Help, then Support. The chatbot will ask you a couple of questions and then open a support ticket. You will receive an email response to your ticket, and you can continue the support by email.

More information regarding our support program is available here: 

Which licenses doI need?

You need a global Cross-Tenant migration license. It is a yearly subscription plus one.

Please contact sales to get a complete quote.