# Agent Migration from On-premise to Cloud

**Last Updated On**: 16 Jul 2026  
**7 minutes read**

## Points to be noted before initiating the migration process

- The associated data with the computers will not be migrated to Cloud.
- The queued configurations associated with each computer will be suspended automatically after migrating the agent.
- The below-mentioned steps should be followed after signing up for Endpoint Central Cloud, and before you add the computer details in the Cloud console.
- This collection should be deployed from Endpoint Central OP console.
- Before deploying the script to the target machines, it is highly recommended to test it on a couple of machines, and then proceed with batch-wise deployment.

To know more about data migration, click [here](https://www.manageengine.com/products/desktop-central/help/migrate-to-endpoint-central.html).

The below-given steps will help you migrate the agents to Endpoint Central Cloud.

## Windows Agent Migration

1. **Download the new agent package**
   - Open the **Cloud web console.**
   - Navigate to the Agent > Computers
   - Select the required remote office
   - Click the Download Agent button
   - Place the downloaded agent installer exe in a folder.

2. **Download the Agent Migration Tool**
   - Copy the `.exe` from this [link](https://workdrive.zohopublic.in/external/3ab253e31db11237c0e4dea1c22d2a02a6540e1ef38a2ab8a628378f4065a8b9/download?directDownload=true) to the previously created folder.

3. **Launch AgentMigrationTool.exe and generate the Agent.exe**
   - Right-click on `AgentMigrationTool.exe` and select **Run as administrator**.
   - Click **Choose Agent Installer** and select your target agent installer (`.exe` file).

![AgentMigrationTool - Choose Agent Installer](https://cdn.manageengine.com/sites/meweb/images/desktop-central/help/server/agent-exe-third-sec.webp)

4. Confirm the displayed **Version** and **Server** information match your destination server.
5. Click **Create Agent.exe** and wait for completion.

![Create Agent.exe](https://cdn.manageengine.com/sites/meweb/images/desktop-central/help/server/agent-exe-third-fifth-above.webp)

6. The `Agent.exe` file will be created in the same directory as the tool.

![Generated Agent.exe](https://cdn.manageengine.com/sites/meweb/images/desktop-central/help/server/agent-exe-thord-fourth.webp)

7. Copy the file Agent.exe to the client machine and run it in **CMD as administrator with /silent argument Eg: > Agent.exe /silent.**

![Run Agent.exe in CMD](https://cdn.manageengine.com/sites/meweb/images/desktop-central/help/server/agentmigrationcmd.webp)

8. Ensure if the migration is working seamlessly.
9. In the Endpoint Central server web console, navigate to **Configuration-> Windows-> Custom Script-> Computer**

![Custom Script - Computer](https://cdn.manageengine.com/sites/meweb/images/desktop-central/help/server/agentmigration3.webp)

10. Enter the name of the configuration and click the Create\Modify script and add the script to repository. Click here to [download the script](https://www.manageengine.com/products/desktop-central/scripts/migrateagent.bat).

![Add script to repository](https://cdn.manageengine.com/sites/meweb/images/desktop-central/help/server/agentmigration4.webp)

11. Once done, select the script in the custom script configuration.
12. In dependency files upload the previously generated Agent.exe file. Select the target and deploy the configuration

![Deploy configuration](https://cdn.manageengine.com/sites/meweb/images/desktop-central/help/server/agentmigration5.webp)

13. Once the changes applied the agent will be moved to the new server console.

## Mac Agent Migration

1. In the Endpoint Central on-premise web console, navigate to **Agent tab -> Agent Settings -> Agent Protection Settings** and disable **Restrict users from uninstalling the Agent and Distribution server**, if enabled.

2. Download Agent Package
   - Open the **Cloud web console.**
   - Navigate to the Agent > Computers
   - Select the required remote office
   - Click the **Download Agent** button
   - Rename the file to UEMS_MacAgent.pkg and place it In a folder.

3. Download **[Migration.sh](https://www.manageengine.com/products/desktop-central/Migration.sh)** to the same directory.

![Mac Migration files](https://cdn.manageengine.com/sites/meweb/images/desktop-central/help/server/mm1.webp)

4. Zip the package with **serverinfo.plist** and **Migration.sh**

![Zip package](https://cdn.manageengine.com/sites/meweb/images/desktop-central/help/server/mm2.webp)

5. Navigate to **Endpoint Central -> Software deployment -> Add Package -> Mac**

6. Create a Mac package by uploading the **Archive.zip** generated. In advanced options, type **sh ./Migration.sh** as shown

![Create Mac package](https://cdn.manageengine.com/sites/meweb/images/desktop-central/help/server/mm3.webp)

7. Create a Mac Software Deployment configuration and deploy the created package to required machines on-premise. It is recommended to apply the configuration to a few test machines first.

## Linux Agent Migration

1. In the Endpoint Central Cloud console, navigate to **Agent tab -> Agent Settings -> Agent Protection Settings** and disable **Restrict users from uninstalling the Agent and Distribution server**, if enabled.

2. Download the **Linux agent**
   - Open the **Cloud web console.**
   - Navigate to the Agent > Computers
   - Select the required remote office
   - Click the **Download Agent** button
   - Rename the file to UEMS_LinuxAgent.bin and place it in a folder.

3. Create a Linux **custom script** configuration.

![Linux custom script](https://cdn.manageengine.com/sites/meweb/images/desktop-central/help/server/op-cloud-migration-linux.webp)

4. Add the script **[copyAgentFiles.bash](https://www.manageengine.com/products/desktop-central/scripts/copyAgentFiles.bash)** to script repository and add below dependency files.
   - DesktopCentral_LinuxAgent.bin/UEMS_LinuxAgent.bin (In the zip file downloaded from DC cloud console)
   - serverinfo.json (In the zip file downloaded from DC cloud console)
   - [LinuxAgentInstaller.bash](https://workdrive.zohoexternal.in/external/a3cfba3077880808f72cc13b79276ed4b567426eaea38ed690fb20f48f7b0ed3)

**Note:** After configuration is successfully applied, it will take a maximum of 10 minutes to installing the new agent. It is recommended to apply the configuration to a few test machines first.

5. Define the targets and apply the configuration.

This way, all the Endpoint Central agents will be migrated from OP to Cloud, thereby ensuring a seamless agent installation process.

**Note:** This feature is applicable for the Cloud edition of Endpoint Central.