migration-migrate.md

title	titleSuffix	description	ms.topic	ms.subservice	ms.contentid	ms.author	author	monikerRange	ms.date
Migrate to Azure DevOps Services	Azure DevOps	How to do a production migration from on-premises to the cloud in Azure DevOps Services.	how-to	azure-devops-migrate		chcomley	chcomley	<= azure-devops	05/20/2024

Migrate to Azure DevOps Services

You completed the Test run phase and familiarized yourself with the process. Now, it’s time to embark on the actual journey of migrating to Azure DevOps Services.

:::image type="content" source="media/migrate-stage-migration-highres.png" alt-text="Diagram of highlighted Migrate stage of the seven stages of migration.":::

Prerequisites

Ensure your test runs result in zero errors before you officially migrate to Azure DevOps Services.

Queue the migration

Do the following steps to queue the migration with the Data Migration Tool.

1. Ensure the migration specification file is complete.
2. Use the following command to queue the migration: Migration /importFile:C:\TFSDataImportFiles\import.json.
   • Ownership: The user who queued the migration owns the migrated organization.
   • Notifications: The owner receives an email for migration success or failure.

Next steps

[!div class="nextstepaction"] Complete post-migration tasks

Related articles

• Validate and prepare for migration
• Prepare for test run
• Do test run migration