Upgrade your deployment to the latest version of TFS

TFS 2018 | TFS 2017 | TFS 2015

The general process for upgrading an existing deployment of Team Foundation Server is to:

  1. Prepare your environment. New system requirements may require you to upgrade hardware or software. And regardless, an upgrade is a good time to consider whether your current environment is meeting your needs, or whether it makes sense to make changes.

  2. Expect the best, prepare for the worst. While we put a lot of effort into ensuring that TFS upgrades are highly reliable, it always makes sense to prepare for the case where something goes wrong. The single most important step you can take here is to ensure you have a complete and consistent set of database backups.

    If you're upgrading in place (not moving to new hardware), consider doing a dry run of your upgrade in a pre-production environment.

  3. Do the upgrade! Once the preparation is done, you'll need to install the new version of TFS to get new binaries, and then run through the upgrade wizard to upgrade your databases.

    Please note the following TFS Upgrade Matrix to see the proper steps to upgrade, based on what version you're upgrading from:

  4. Configure new features. Depending on what version you upgraded from, you may need to configure each project to gain access to some of the new features made available. You don't have to do this immediately, but those features aren't available in that project until they're configured. Depending on the project, you'll use some combination of the Configure Features wizard that appears on the Work page and some manual configuration.

Before you upgrade to TFS 2018

As of TFS 2017.2, the old work item form tag has been deprecated and is no longer supported in TFS 2018. If you are upgrading your server and have a collection where the new work item form has not been enabled you will encounter the following severe warning during readiness checks:

[VS403364]: This release introduces major updates to the work item form layout and functionality and deprecates legacy custom controls. Consequently, the upgrade process will update all work item type definitions to use the new work 
item form WebLayout element and remove all custom controls. For additional information and recommended upgrade steps, see the Deployment Guide.

We recommend that you review handling a TFS 2018 upgrade from old form to new form for further guidance.

Before you upgrade to TFS 2017

If you use TFS-Project Server integration to synchronize data between TFS and Project Server, then you'll want to review the following two topics:

Also, we recommend that you review the options you have when you upgrade from TFS 2008 or TFS 2010. Depending on the amount of customization you've made to your work tracking process, you'll want to choose between the options described.


Upgrading a TFS deployment can be quite straightforward or quite complicated, depending on the specifics of your existing deployment. Factors that will influence the complexity and duration of your upgrade include:

  • How many servers are involved in your deployment.
  • Whether your deployment is configured with SharePoint integration or reporting.
  • How large your databases are.
  • How old a version you are upgrading from.

In all cases, however, the general process is logically the same. Get your environment ready; Expect the best, prepare for the worst; and finally, do the upgrade.


Your TFS deployment will be offline for the duration of the upgrade. Upgrade times can be measured in minutes for very small deployments or in days for very large deployments. You can keep your upgrades comparably speedy by cleaning up unnecessary data. If you're keeping up with the latest versions of TFS, that helps a lot, too.

If you're upgrading a very large database to TFS 2015, consider using the TfsPreUpgrade tool. It performs the most expensive parts of the upgrade from TFS 2013 QU4/QU5 in the background, allowing you to continue using TFS. This tool can cut offline times for upgrade significantly for large databases - one internal Microsoft database went from over a week of offline time down to under a day.


Walk through a TFS Express upgrade - this is as simple as it gets.

Walk through a standard upgrade scenario - upgrading a two server deployment from TFS 2012 to TFS 2015.

Walk through an upgrade from TFS 2005 to TFS 2015.

We will be covering more advanced scenarios - things like upgrading deployments which have multiple application tiers in a load balancer, deployments which have their databases in SQL Always On availability groups, etc. - in future updates. In the meantime, the documentation for TFS 2013 and earlier is still relevant and can provide some guidance for these more advanced scenarios.