OpsHub Integration Manager

No-code integration platform for rich bi-directional sync

OpsHub Migration Manager

Zero downtime migration to tool of your choice

OpsHub Archive Manager

Keep Historical Data, Without Slowing Down Your Tools

OpsHub Migrator for Microsoft Azure DevOps

Migrate or restructure Azure DevOps Instances

OpsHub Data Bridge

Real-time, context-rich data lake for AI or analytics

Discover our story, vision, and impact.

By Domain

Software Development & Agile Engineering

No-code integration across teams & systems

IT Service Management & Customer Support

Enable collaboration between IT, support & business teams

Product Lifecycle Management & Systems Engineering

Connect PLM & engineering teams for smarter products

Requirements Management for Regulated Industries

Ensure regulatory compliance from start to release

Blogs

Explore the latest in technology and best practices

Case Studies

Success stories from the field

White Papers

Actionable insights for your business challenges.

Videos

See solutions in action

EBooks

Learn, plan, and execute with confidence

Press Releases

Official announcements and updates

Webinars

Join discussions that drive results

News Letters

Stay ahead with curated insights

Blog

How to integrate Salesforce and Jira in 2026(A step-by-step guide)

Salesforce captures customer-facing activities while Jira manages engineering execution. Integrating the systems reduces manual handoffs and improves transparency across teams. This guide covers architectural considerations, mapping strategies, and integration best practices.

Blogs

Explore the latest in technology and best practices

Case Studies

Success stories from the field

White Papers

Actionable insights for your business challenges.

Videos

See solutions in action

EBooks

Learn, plan, and execute with confidence

Press Releases

Official announcements and updates

Webinars

Join discussions that drive results

News Letters

Stay ahead with curated insights

Compare-2.png

Compare

See side by side comparison

6 Common Azure DevOps Migration Scenarios and How to Handle Them

Azure DevOps migration is not a one-size-fits-all project. It includes several scenarios, each with different data, systems, and risk levels. A team moving from on-premises TFS to the cloud faces different decisions than a team merging two Azure DevOps instances after an acquisition. This article covers 6 possible Azure DevOps migration scenarios, what triggers each one, what needs to be preserved, and how teams typically plan and execute each one.

Muskaan Pathak

July 20, 2026

share this post:

What is an Azure DevOps migration?

Direct answer: An Azure DevOps migration is the process of moving work items, version control history, test data, pipelines, and project configuration from one Azure DevOps or TFS environment to another.

This can mean moving from an on-premises server to the cloud, combining several instances into one, splitting a single instance into several, or moving projects within the cloud itself. Each of these is a different scenario with its own planning steps.

Why do Azure DevOps migration scenarios need different approaches?

Each Azure DevOps migration scenario involves different data types, migration volumes, and source or target systems, so a single migration plan rarely works well for every case.

  • The systems involved differ: on-premises TFS, Azure DevOps Services, or both.
  • The trigger differs: a merger, a cloud shift, a compliance requirement, or a version reaching end of support.
  • The data volume differs: a single project versus hundreds of projects across multiple teams.
  • The risk differs: consolidating instances can create naming conflicts and template mismatches that a simple lift-and-shift does not.

Understanding which scenario applies to your situation is the first step in planning a migration that keeps history, traceability, and team productivity intact.

What are the 6 common Azure DevOps migration scenarios?

These are the 6 scenarios teams run into most often when planning an Azure DevOps or TFS migration:

Each is covered below, including when it applies, what needs to be preserved, the main challenge, and how it is typically handled. 

1. How do you migrate from TFS to Azure DevOps (cloud)?

Direct answer: This scenario moves projects from an on-premises TFS server to Azure DevOps Services in the cloud, while keeping work items, test data, pipelines, and version control history intact.

When this happens

  • The current TFS version is approaching end of support.
  • Teams want cloud-based collaboration and scaling without managing server infrastructure.
  • The organization is reducing the cost of maintaining on-premises hardware.

What needs to be preserved

  • Work item history and revisions, including original dates and IDs.
  • TFVC changesets and their history.
  • Test cases, test plans, and test results.
  • Pipelines, dashboards, queries, and area or iteration structure.
  • Links between work items and changesets.

Main challenge

Moving a large volume of historical revisions to the cloud without breaking the links between work items, code changes, and test assets.

How it is typically handled

A guided, UI-based migration tool connects directly to the TFS server and the target Azure DevOps organization, maps process templates and user identities, and transfers data while both environments stay usable. Teams can migrate directly to Azure DevOps without first upgrading TFS to a newer on-premises version, and the target organization does not need to be empty before migration starts.

2. How do you merge multiple Azure DevOps or TFS instances into one?

Direct answer: This scenario consolidates multiple Azure DevOps (cloud) or TFS environments into a single instance, typically after a merger, acquisition, or internal restructuring.

When this happens

  • Two organizations merge and need one shared Azure DevOps environment.
  • Separate business units have been running on different instances and need to consolidate.
  • Licensing or governance policy requires one instance instead of several.
  • Managing licensing across multiple instances becomes costly.

What needs to be preserved

  • Project and area names, checked for conflicts across source instances.
  • Work item type mapping, when source instances use different process templates.
  • Cross-project links and relationships.
  • User identity mapping between the source instances and the target instance.

Main challenge

Reconciling different process templates, field structures, and naming conventions from multiple sources into one consistent target without losing history.

How it is typically handled

Migration tools convert the varied source formats into one consistent target structure and support template changes as part of the move. Fields, users, and processes are mapped before the final cutover, and the migration is validated in stages so issues surface before they affect production data.

3. How do you split projects across multiple Azure DevOps instances?

Direct answer: This scenario divides a single Azure DevOps or TFS instance into multiple separate instances, often needed when a business unit is spun off, restructured, or requires an isolated environment.

When this happens

  • A business unit is divested or spun off into its own company.
  • A subsidiary needs its own instance for security or compliance reasons.
  • Teams are being separated into different tenants or license agreements.

What needs to be preserved

  • The specific projects being moved, without touching the rest of the source environment.
  • Cross-project links that reference data staying in the original instance.
  • Work item and version control history for the projects being split out.

Main challenge

Extracting a clean subset of projects without leaving broken references behind in either the source or the target environment.

How it is typically handled

Selective, project-level migration moves specific projects to a new or already active target instance, so the rest of the source environment is left untouched. Because the target does not need to be empty, the split projects can land directly in an existing organization.

4. How do you migrate Azure DevOps cloud to cloud (tenant to tenant)?

Direct answer: This scenario transfers projects between two Azure DevOps cloud organizations, or between two tenants, while preserving work items, change history, user identities, pipelines, and relationships.

When this happens

  • An organization is consolidating multiple cloud tenants into one.
  • A subsidiary’s Azure DevOps organization is being folded into the parent company’s tenant.
  • Teams need to move from a personal or trial organization into a corporate one.

What needs to be preserved

  • User identity mapping across tenants, including domain-linked and live accounts.
  • Pipeline definitions, dashboards, widgets, and saved queries.
  • Work item and test entity history.

Main challenge

Matching users and identity structures across two separate Microsoft Entra (Azure AD) tenants, since accounts do not automatically carry over between them.

How it is typically handled

One-to-one and many-to-one user identity mapping connects source accounts to the correct target accounts before migration starts. A guided UI platform lets teams configure and repeat the same migration setup across many projects and teams without slowing down either organization.

5. How do you upgrade TFS to a newer on-premises version?

Direct answer: This scenario migrates projects between two on-premises Azure DevOps Server (Team Foundation Server) versions, keeping data integrity and full history intact while moving to a newer, supported release.

When this happens

  • The current TFS Server version is reaching end of support.
  • The organization is refreshing on-premises hardware.
  • Multiple on-premises collections are being consolidated onto one server.
  • A single on-premises collection is being divided into multiple instances.

What needs to be preserved

  • TFVC history and changesets.
  • Work item revisions and their relationships.
  • Area and iteration structure.

Main challenge

Handling schema and process template differences between TFS versions without causing downtime for active development teams.

How it is typically handled

Migration tools that support all Azure DevOps Server (TFS) versions from 2010 through 2022 move data between old and new on-premises collections directly, preserving cross-project links. The migration is validated in stages before the final cutover so teams can confirm data integrity before switching over.

6. How do you migrate Azure DevOps (cloud) to TFS?

Direct answer: This scenario moves projects from Azure DevOps Services back to an on-premises TFS environment, keeping history, traceability, and project relationships intact.

When this happens

  • Data residency or compliance rules require projects to stay on-premises.
  • Teams need a network-isolated environment, common in defense and regulated industries.
  • A contract or policy restricts storing project data in the cloud.

What needs to be preserved

  • Full work item and TFVC history.
  • Test entities and their results.
  • Cross-project traceability between work items, code, and tests.

Main challenge

Some cloud-only features, such as certain widgets or pipeline types, do not have an exact on-premises equivalent, so they need careful mapping during the move.

How it is typically handled

Migration tools map cloud entities to their closest on-premises equivalents and run pre-migration checks that flag source data differences before they reach the target. The migration is staged and validated in phases rather than moved in a single pass, so issues are caught before the final cutover.

What are the key challenges across all Azure DevOps migration scenarios?

Each Azure DevOps migration scenario is different, but many of the underlying risks are the same. Whether you are moving from TFS to Azure DevOps Services, merging multiple instances, splitting projects, or migrating between cloud organizations, the migration has to protect the relationships between people, processes, code, work items, test data, and pipelines.

The most common challenges include:

  • Preserving historical traceability between work items, changesets, commits, test results, builds, and releases.
  • Matching process templates, custom fields, workflow states, and business rules between the source and target environment.
  • Mapping user identities across domains, tenants, or Microsoft Entra ID profiles before migration starts.
  • Keeping active engineering teams productive while migration is running in the background.
  • Preventing pipelines, service connections, dashboards, queries, and test assets from breaking after cutover.
  • Recovering from migration errors without restarting the entire migration from scratch.
  • Validating migrated data before final cutover instead of discovering broken links, missing attachments, or identity gaps later.

These challenges are often the reason Azure DevOps migration becomes more involved than a simple data transfer. For a deeper breakdown of these risks and how to solve them, read our detailed guide on Azure DevOps migration challenges in 2026.

Way forward

Once your scenario and the capability it needs are clear, the work left is turning that into a plan. These five steps cover what to do, and what tends to go wrong when a step gets skipped.

1. Start with a pilot, not the full migration

Run one project through the mapping and migration process before committing the rest. Teams that skip this step and go straight to a full migration are the ones most likely to discover mapping problems midway through, when they are harder to fix.

2. Map users and process templates before you start

Confirm user identities and process templates ahead of time, not during the migration itself. Migrations that begin without this mapping in place tend to stall partway through while someone tracks down missing accounts or mismatched fields.

3. Check your source data before you migrate it

Look for broken links, orphaned records, and undocumented custom fields before the migration starts, and do not assume version control history will transfer correctly without checking it against the source. Issues found here are far cheaper to fix than issues found after cutover.

4. Migrate in phases and validate each one

Move projects in stages rather than all at once, and confirm each stage before starting the next. This also protects cross-project links, which are one of the first things to break when an entire environment moves in a single pass. to discover mapping problems midway through, when they are harder to fix.

5. Keep both environments in sync and schedule cutover deliberately

Keep the source and target usable until the final cutover is confirmed, and schedule that cutover for a low-activity period even if the migration itself causes no downtime. This gives teams a safety net if something needs a second look before it becomes permanent.

Reduce migration risk and ensure a smooth Azure DevOps transition with expert guidance.

Get expert guidance for your Azure DevOps move

Talk to an ADO migration expert

Trusted by forward-thinking teams across the globe