Troubleshoot connecting to a project

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

Troubleshoot Azure DevOps Server connectivity

Here's a list of the most frequently reported connection problems and what to do about them. Complete the list in the order indicated.

  1. Verify that you have the required permissions.

    If the errors that you receive indicate read-only or blocked actions, you might not have permissions to act on the data.

  2. Verify that your computer is connected to the network and that it can access network resources.

  3. Verify that Azure DevOps Server hasn't been taken offline. Talk with your Azure DevOps Server administrator.

  4. Check whether your project has been moved to another project collection in Azure DevOps Server. If it has been moved, you must create a connection to the new server name.

For additional troubleshooting tips, see TF31002: Unable to connect to this Azure DevOps Server.

Connect to Azure DevOps Server with Secure Sockets Layer

If you connect to an Azure DevOps Server instance that has Secure Sockets Layer (SSL) configured, install a certificate and clear the client cache. For details, see Set up HTTPS with Secure Sockets Layer (SSL) for Azure DevOps Server - Configuring client computers.

Clear the cache on client computers

When the on-premises Azure DevOps Server configuration changes, such as when you move or split a project collection, clear the cache.

  1. Sign in to your client computer for Azure DevOps Server by using the credentials of the user whose cache you want to clear.

  2. Close any open instances of Visual Studio.

  3. Open a browser and go to one of the following folders, depending on the operating system your computer runs on:

    • Windows 10 Drive:\Users<i>UserName\AppData\Local\Microsoft\Team Foundation\6.0\Cache

    • Windows 8 Drive:\Users<i>UserName\AppData\Local\Microsoft\Team Foundation\4.0\Cache

    • Windows 7 or Windows Vista Drive:\Users<i>UserName\AppData\Local\Microsoft\Team Foundation\2.0\Cache

  4. Delete the contents of the Cache directory, including all subfolders.