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.
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.
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.
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