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

Compare-2.png

Evaluation Toolkit

Evaluate before you buy

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

How to migrate from TFS to Azure DevOps in 2026: a step-by-step guide

TFS isn’t getting any newer, but migrating years of work to Azure DevOps doesn’t have to be disruptive. This blog walks through a five-step migration approach that makes your TFS to ADO migration easier while preserving work item history, TFVC data, links, and user mappings, and explains how to plan, execute, validate, and complete the cutover while teams keep working.

Devang Rathod

TL;DR

Teams leaving TFS must move years of work items, TFVC history, links, and users to Azure DevOps Services without stopping delivery. Microsoft’s Data Migration Tool needs an upgrade to a recent Azure DevOps Server release first, and moves the whole collection in one lift and shift. OpsHub Migrator for Microsoft Azure DevOps (OM4ADO), co-developed with Microsoft, reads TFS and Azure DevOps Server versions 2010 through 2022 directly, with no upgrade. It is UI-based with no code, migrates the projects you choose in phases, keeps full history and fidelity, and its delta sync lets teams keep working. Its Free edition has no license key.

Why are teams moving from TFS to Azure DevOps in 2026?

Teams move off TFS for three main reasons:

  • Support is running out. On 11 January 2027, Team Foundation Server 2017 reaches the end of extended support, and TFS 2018 follows on 11 January 2028. After those dates, Microsoft stops releasing security fixes for them, which leaves the server exposed. Check your release on Microsoft’s lifecycle and servicing page.
  • Server upkeep stays with your team. On TFS, your team runs the servers, the SQL databases, the patches, and the upgrades. Azure DevOps Services removes that work, because Microsoft hosts it.
  • The organization changed. A merger or a reorganization can leave several TFS instances to combine, or one large instance to split.

What makes TFS to Azure DevOps migration difficult?

A TFS migration is harder than copying files, because a project is years of connected data. When it goes wrong, the cost is delayed delivery, lost traceability, and broken access. These are the risks that make it hard:

  • Delivery stalls during a freeze. If the migration needs a freeze, teams stop committing, releases slip, and deadlines move.
  • Lost history breaks traceability. If TFVC branches, changesets, and work item history do not move exactly, teams lose the audit trail and cannot trace a change back to its requirement, which fails compliance and audit checks.
  • Broken links hide the delivery chain. Work items link to builds, releases, repositories, and test cases, and broken links hide that history, so reporting and impact analysis stop working.
  • Access and ownership break. If source users do not map to target users, people lose access on day one and past work shows the wrong owner.
  • Custom templates stall the move. Custom fields and picklists with no match in Azure DevOps are a common cause of process template customization failures that halt or corrupt the migration.

To see how these problems appear in real migrations and how teams fix them, read common pitfalls in Azure DevOps migrations and how to avoid them.

What are your options for migrating from TFS to Azure DevOps?

Four approaches cover most TFS to Azure DevOps migrations. The table shows what each is best for and its key points.
Option Best for Key points
Microsoft native Data Migration Tool A one-time, full-collection move to Azure DevOps Services
  • Command-line tool
  • Moves the whole collection at once into an empty target
  • Needs a recent Azure DevOps Server release, so older TFS upgrades first
  • Source is read-only during the run, and there is one production run
OM4ADO Phased, selective, consolidation, or large migrations
  • Free and UI-based
  • Full, phased, and selective project migration
  • Delta migration, so teams keep working
  • Resumes from the last checkpoint after a failure
  • Moves work items, repositories, pipelines, test assets, users, and teams
Planview Hub Connecting and syncing data across many ALM and Agile tools
  • Migrates and syncs work items, requirements, test cases, and links
  • Does not move TFVC, Git, or source control history
  • Pipelines, dashboards, and some configurations need separate migration
CSV import and export Very small work item moves and backlog cleanup
  • Spreadsheet import and export of work items
  • No repositories, pipelines, test assets, or source history
  • Limited history and link preservation
  • Manual validation needed after import

For a full side-by-side comparison of every tool, read best Azure DevOps migration solutions in 2026.

What moves in a TFS to Azure DevOps migration, and what does not?

The table below shows what moves in a TFS to Azure DevOps migration, and how each item is migrated.
Data item How it migrates
Work items All types, standard and custom, with full revision history and comments
Attachments and media Attachments, inline images, and user mentions
Links Work item relationships and changeset-to-work-item links
TFVC source code Changesets with their full version history
Changeset labels Migrated with the changesets they mark
Test assets Test plans, suites, and runs
Pipelines Build and release pipeline configurations
Dashboards and queries Queries, dashboards, and widgets
Area and iteration Paths and their hierarchy
Users Users, teams, and groups
Git repositories Repositories with their history

A custom field with no match in the target needs a home before the run, or its data has nowhere to go. For the pipeline layer, including what you must rebuild by hand, read how to migrate builds, releases, and pipelines in Azure DevOps.

Run your first TFS to Azure DevOps migration

Try OM4ADO Free and move TFS work items, history, comments, attachments and TFVC changesets to Azure DevOps.

How do you migrate from TFS to Azure DevOps in 5 steps?

The migration follows five steps. The same five work for one small project or a full estate.

Step 1: Scope what moves

Decide which projects move and how far back their history must go, and pick your target: Azure DevOps Services, or a newer Azure DevOps Server release if you must stay on-premises. Size the work before you choose an edition. The Data Discovery Utility is a read-only scan of your source that counts work items, revisions, and changesets, so the numbers guide the plan. Settle the repository question now too, because OM4ADO moves TFVC as TFVC with its history, and moving to Git is a separate decision.

Step 2: Assess the source and the people

Confirm your version, then prepare the source and the people. Back up your TFS databases, and test that the backup restores. Create or invite each user in the target organization before the run, or the migrated work shows the migrating account as the author instead of the real person. Set access tokens so the source can be read and the target can be written to. Pre-migration checks flag source data issues early, so you fix them before the full run. The TFS to Azure DevOps migration video shows the setup and run on screen.

Step 3: Migrate in a pilot, then for real

Connect the source and target, and test the connection before you start, because a connection that drops mid-run wastes more time than the test takes. Run a pilot on one real project first. Then run the full migration, which moves the historical data. After that, delta sync copies only what changed since the last run, so teams keep working while it catches up. If one item fails, OM4ADO logs it and continues, and the run resumes from the last checkpoint once you fix the cause.

Step 4: Cut over

Run one last delta sync close to the switch. Because the history already moved, this final sync is small and quick. Announce the switch, freeze the last changes, and move teams to Azure DevOps, so cutover is a short planned event rather than a long outage. Then repoint Visual Studio connections, build agents, and service connections at the new organization. OpsHub and infiNetix ran a TFS to Azure DevOps migration under a tight deadline with no downtime this way.

Step 5: Validate and settle

Check the result in two passes. First, compare counts: source work items against target, and source changesets against target. Second, open individual work items of different types, and compare their history, comments, attachments, and links against the source, because a count alone misses a link that still points at the old server. Confirm permissions, pipelines, and agents work. Keep the source read-only until each team signs off, then retire it. CSI Leasing validated its TFS to Azure DevOps move this way.

For the full pre-migration and go-live list, follow the Azure DevOps migration checklist.

What should you do next?

To migrate from TFS to Azure DevOps in 2026, you scope what moves, assess the source and the people, migrate in a pilot and then for real, cut over, and validate the result. Every TFS and Azure DevOps Server version from 2010 to 2022 migrates directly to Azure DevOps Services, with no prior upgrade.

OM4ADO is co-developed with Microsoft and has been used to migrate more than 2 billion work item revisions. It reads TFS 2010 through 2022 directly, runs through a user interface with no code, and moves the projects you select in phases with full revision history. Its delta sync lets teams keep working, so there is no development freeze, and its Free edition has no license key. For a plan mapped to your own TFS environment, book a slot with a migration engineer.

Frequently asked questions

Can I migrate directly from TFS 2018 or older, or must I upgrade first?

With OM4ADO you can migrate directly, because it reads TFS and Azure DevOps Server versions 2010 through 2022 as sources. Microsoft’s Data Migration Tool needs the source on one of the two most recent Azure DevOps Server releases, so older servers must upgrade first.

Can I migrate only some projects instead of the whole collection?

Yes. OM4ADO moves only the projects you select, and the rest of the collection stays where it is. Microsoft’s tool moves one whole collection into one new organization, with no way to pick single projects.

Is the migration free?

The OM4ADO Free edition migrates from TFS or Azure DevOps Server to Azure DevOps Services at no cost and with no license key, up to 1,000 work items and 1,000 TFVC changesets. The run stops once it reaches that limit. The Pro edition removes the limit and adds data such as test plans, pipelines, dashboards, area and iteration paths, and user groups.

How long does a TFS to Azure DevOps migration take, and do I need a source freeze?

The time depends on data volume, mainly revisions, changesets, and attachments, so a fixed number without seeing your data would be a guess. With OM4ADO, delta sync moves the history ahead of time and teams keep working, so you do not need a development freeze. Only the short cutover is planned downtime.

Can I run the production migration more than once?

With OM4ADO, yes. You can run it, widen the scope, and run again without deleting what already moved. Microsoft’s tool allows one production run per collection, so a mistake there means starting over.

What happens if a migration run fails partway?

OM4ADO logs the failed item and keeps the run going, so one problem does not stop everything. Once you fix the cause, the migration resumes from the last checkpoint. A pilot run finds most causes before the production run.

Can I merge several TFS collections into one organization?

Yes, with OM4ADO. It can bring several source collections into one Azure DevOps organization. The full method is in the guide to merging multiple Azure DevOps or TFS instances.

Get OM4ADO free and start your TFS to ADO migration

See exactly what your migration involves

Bring your Azure DevOps setup and talk through the mapping and a pilot plan.

Customer Logos