Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
331 lines (186 sloc) 15.2 KB

title: Connect to project from browser/supported client titleSuffix: Azure DevOps description: Learn how to connect a client to the cloud service Azure DevOps or on-premises ms.technology: devops-new-user ms.prod: devops ms.topic: quickstart ms.assetid: 1372e56c-b34f-42c2-b72c-94b57620c75c ms.manager: mijacobs ms.author: sdanie author: steved0x ms.date: 11/15/2019 monikerRange: '>= tfs-2013'

Quickstart: Connect to a project in Azure DevOps

[!INCLUDE temp]

In this quickstart, you learn how to connect to a project to share code, build apps, track work, and collaborate with team members. You can use any of the following clients:

A project defines a process and data storage in which you manage your software projects from planning to deployment. When you connect to a project, you connect to an organization or project collection. One or more projects may be defined within a collection. There must be at least one project. For more information, see About projects and scaling your organization.

Prerequisites

Connect from the web portal

  1. If you're not a member of a security group, ask your Project Administrator to add you.

  2. Open a browser and enter a URL that uses the following form:

    ::: moniker range="azure-devops"

    https://dev.azure.com/OrganizationName/ProjectName 

    ::: moniker-end

    ::: moniker range=">= tfs-2013 <= azure-devops-2019"

    http://ServerName:8080/tfs/DefaultCollection/ProjectName

    For example, to connect to the server named FabrikamPrime, type: http://FabrikamPrime:8080/tfs/.

    The default Port is 8080. If you don't use default values, specify the port number and directory for your server. ::: moniker-end

  3. When you access the server for the first time, a Windows Identity dialog box appears. Enter your credentials and choose OK.

    [!TIP] If you select Remember me, you won't have to enter your credentials the next time you connect.

  4. Choose your project, team, or page of interest.

    ::: moniker range=">= azure-devops-2019"

    From the project summary page, hover over a service and then choose the page you want. To choose another project, choose Azure DevOps. Azure DevOps logo

    [!div class="mx-imgBorder"]
    Choose a service page, horizontal nav

    ::: moniker-end

    ::: moniker range=">= tfs-2017 <=tfs-2018"

    From the project summary page, hover over a service and then choose the page you want. To choose another project, choose the Azure DevOps logo Azure DevOps logo.

    [!div class="mx-imgBorder"]
    Choose a service page, horizontal nav

    ::: moniker-end

    ::: moniker range=">= tfs-2013 <= tfs-2015"

    Choose your project or team from the set of available links, or choose Browse to access all projects and teams.

    Web portal, TFS, Overview

    ::: moniker-end

To learn more about each page and the tasks you can do, see Web portal navigation.

Sign in with different credentials

::: moniker range=">= tfs-2013 <= tfs-2015"

  1. Open Windows Security from the context menu associated with your name.

    Sign in As link in user profile menu

  2. Enter your credentials.

    Enter user name and password to access TFS

::: moniker-end

::: moniker range=">= tfs-2017"

  1. Open your profile menu and choose Sign out.

    [!div class="mx-imgBorder"]
    Sign out

  2. Choose Sign in and enter your credentials.

::: moniker-end

Open the web portal from Team Explorer

Open the web portal from the home page.

Connect to the web portal

Connect from Visual Studio or Team Explorer

If you haven't already, download and install a version of Visual Studio.

If you're not a member of an Azure DevOps security group, get added to one. Check with a team member. You'll need the names of the server, project collection, and project to connect to.

Visual Studio 2019

Visual Studio 2019

  1. Select the Manage Connections button in Team Explorer to open the Connect page. Choose Connect to a Project to select a project to connect to.

    connect to projects

    Connect to a Project shows the projects you can connect to, along with the repos in those projects.

    Connect to a Project dialog box

  2. Select Add Azure DevOps Server to connect to a project in Azure DevOps Services. Enter the URL to your server and select Add.

    ALM_EXL_AddServer

  3. Select a project from the list and select Connect.

Visual Studio 2017

Visual Studio 2017

  1. Select the Manage Connections button in Team Explorer to open the Connect page. Choose the Connect to Team Project link to select a project to connect to.

    connect to projects

    Connect to a Project shows the projects you can connect to, along with the repos in those projects.

    Connect to a Project dialog box

  2. Select Add Server to connect to a project in Team Foundation Server. Enter the URL to your TFS server and select Add.

    ALM_EXL_AddServer

  3. Select a project from the list and select Connect.

Visual Studio 2015

Visual Studio 2015

  1. Select the Manage Connections button in Team Explorer to open the Connect page. Choose Connect to Team Project to select a different organization, TFS, or project to connect to.

    connect to projects

  2. Select the projects to work on.

    Connect to Team Foundation Server dialog box

    If it's your first time connecting, add TFS to the list of recognized servers.

    ALM_EXL_AddServer

If you selected just one project, you'll see the Home page for that project. The pages differ based on the resources enabled and the source control system selected for your project.

Team Explorer displays the Home page for that project. The pages that appear differ based on the resources enabled and the source control system selected for your project.

[!div class="mx-tdBreakAll"]
|Home page with Git |Home page with TFVC | |-------------|----------| |Team Explorer Home page with Git as source control|Team Explorer Home page w/ TFVC as source control|

To learn more about each page and the tasks you can do, see Navigate in Visual Studio Team Explorer.

Your client remembers the set of connections you've configured. You can switch from one project to another from the Connect page.


Change sign-in credentials

Visual Studio 2019

Visual Studio 2019

  1. From Connect, choose the Connect to a Project link to sign in with different credentials.

    connect to projects

  2. Select a different user or select Add an account to access a project using different credentials.

    Connect with VS using different credentials to sign in

  3. Sign in using an account that is associated with an Azure DevOps project, either a valid Microsoft account or GitHub account.

Visual Studio 2017

Visual Studio 2017

  1. From Connect, choose Connect to Team Project to sign in with different credentials.

    connect to projects

  2. Select a different user from the drop-down or select Add an account to access a project using different credentials.

    Connect with VS 2017 using different credentials to sign in

  3. Sign in using a valid Microsoft account that is associated with an Azure DevOps Services or TFS project.

Visual Studio 2015

Visual Studio 2015

  1. From Connect, choose Connect to Team Project to sign in with different credentials.

    connect to projects

    The Switch User link appears only when you're actively connected to a project on Azure DevOps Services.

    Connect to Team Foundation Server dialog box

  2. Sign in using a valid Microsoft account that is associated with Azure DevOps Services or a TFS project.


Use different Visual Studio credentials

You can run Visual Studio with credentials different from your current Windows user account. Find devenv.exe under the Program Files (86) folder for your version of Visual Studio.

Select Shift and right-click devenv.exe, then select Run as different user.

Context menu for Visual Studio devenv.exe

User accounts and licensing for Visual Studio

To connect to a project, you need your user account added to the project. The organization owner (Azure DevOps Services) or a Project Administrator usually does adds user accounts.

::: moniker range="azure-devops" Azure DevOps Services provides access to the first five account users free. After that, you need to pay for more users. ::: moniker-end

::: moniker range=">= tfs-2013 <= tfs-2018"

For on-premises TFS, each user account must have a TFS client access license (CAL). All Visual Studio subscriptions and paid Azure DevOps Services users include a TFS CAL. Find out more about licensing from the Team Foundation Server pricing page.

::: moniker-end

You can also provide access to Stakeholders in your organization who have limited access to select features as described in Work as a Stakeholder.

Configure Visual Studio to connect to Azure DevOps Proxy Server

If your remote team uses a Azure DevOps Proxy Server to cache files, you can configure Visual Studio to connect through that proxy server and download files under Team Foundation version control.

  1. First, make sure that you've connected to Azure DevOps Server as described in the previous section.

  2. From the Visual Studio Tools menu, select Options, then select Source Control > Plug-in Selection. Select Visual Studio Team Foundation Server.

    Plug-in Selection page, Options dialog box

  3. For Visual Studio Team Foundation Server, enter the name and port number for the Azure DevOps Proxy Server. Select Use SSL encryption (https) to connect.

    VS TFVC proxy configuration page, Options dialog

    Make sure you specify the port number that your administrator assigned to TFS Proxy.

To associate a file type with a compare or merge tool, see Associate a file type with a file-comparison tool or Associate a file type with a merge tool.

What other clients support connection to Azure DevOps?

Besides connecting through a web browser, Visual Studio, Eclipse, Excel, and Project you can connect to a project from these clients:

Requirements and client compatibility

Some tasks or features aren't available when you connect to a later version of Azure DevOps Server than your client supports. For more information, see client compatibility.

Determine your platform version

See Feedback and support.

Next steps

Learn more about how to:

If all you need is a code repository and bug tracking solution, then start with the Get Started with Azure Repos and Manage bugs.

To start planning and tracking work, see Get started with Agile tools to plan and track work.

You can’t perform that action at this time.