Create a project in Azure DevOps and TFS

Azure DevOps Services | Azure DevOps Server 2019 | TFS 2018 | TFS 2017 | TFS 2015 | TFS 2013

This article describes how to use Azure DevOps to create a project and establish a repository for source code. Teams and groups of developers can plan, track progress, and collaborate on building software solutions. Each project you create provides boundaries to isolate data from other projects. Managed and structured each project to support your business needs. To learn more about projects and when to create one, see About projects and scaling your organization.

Note

This article is about creating a project in Azure DevOps or a Team Foundation Server. If instead you want to create Azure DevOps Projects, see Azure DevOps Projects.

If you have a project already, see Get Started with Azure Repos and Visual Studio.

Note

If you don't want to manage an on-premises server, you can sign up for Azure DevOps Services and create a project. For more information, see Quickstart: Create an organization or project collection.

Prerequisites

  • You create a project within a project collection. If you haven't created a project collection yet, do that now. See Create a project collection.

  • You must be a member of the Project Collection Administrators group or have the Create new projects permission set to Allow. If you aren't a member, get added now. For more information, see Set permissions at the project- or collection-level.

  • Ask your TFS administrator about the following resources and get additional permissions as needed:

    • Which project collection should you connect to when you create your project? If you installed TFS using the Basic Server Configuration Wizard, you have only one project collection named DefaultCollection. Unless you support hundreds of projects, you should create all your projects within a single project collection. If you need to create additional collections, see Manage project collections.

    • Have you configured SQL Server Analysis Services and SQL Server Reporting Services for the deployment? If so, ask your administrator to add you as a member of the Team Foundation Content Managers group. You must be a member of this group on the server that hosts SQL Server Reporting Services. Without these permissions, you can't create a project. For more information, see Grant permissions to view or create SQL Server reports in TFS.

    • Have you configured a SharePoint Web application for your deployment? You can configure a SharePoint portal when you create your project. To do so, contact your SharePoint administrator to give you Full Control permissions on the server that hosts SharePoint Products. Otherwise, you can skip this step and configure a portal at a later time.

Important

To create a public project, or to make a private project public, see Create a public project in your organization or Change the project visibility, public or private. Additional policy settings must be enabled to work with public projects.

Create a project

When you create a project, the main options you specify are:

  • The organization or project collection where the project is defined. For guidance, see About projects and scaling your organization.
  • A project name. Your project name can't contain special characters, such as / : \ ~ & % ; @ ' " ? < > | # $ * } { , + = [ ], can't begin with an underscore, can't begin or end with a period, and must be 64 or fewer characters.
  • An optional project description.
  • The type of repository used for initial source control, either Git or Team Foundation version control (TFVC). Git is the default. You can add any type of repository later to your project. For guidance, see Choosing the right source control for your project.
  • The process that determines the work item types available for tracking work using Azure Boards. If you don't specify a process, the default is Agile. For guidance, see Choose a process.
  1. Select Azure DevOps to open the Projects page. Azure DevOps logo

  2. Choose the organization, and then select Create Project.

    Open Projects

  3. Enter information into the form provided. Provide a name for your project. Choose the visibility, initial source control type, and work item process. For guidance, see Choosing the right version control for your project and Choose a process.

    Create new project form, latest vsts

    Select visibility of either public or private. If you choose public visibility, anyone on the internet can view your project. With private visibility, only people who you give access to can view your project. For details on public projects, see Create a public project in your organization. If the Public option is not available, you need to change the policy.

  4. Select Create. The welcome page appears.

    Project creation confirmation dialog, new nav

    Select one of the following options to get started:

  1. Select Azure DevOps to open the Projects page. Azure DevOps logo Then select Create Project.

    Open Projects

  2. In Create a new project, provide a name for your project, and optionally a description. Expand Advanced to select the initial source control type and work item process.

    Create new project form, 2019

    For guidance, see Choosing the right version control for your project and Choose a process.

  3. Select Create. The welcome page appears.

    Project creation confirmation dialog, new nav

    Select one of the following options to get started:

  1. Select Azure DevOps to open the Projects page. Azure DevOps logo Then select New Project.

    Choose new project, horizontal navigation

  2. Fill out the form provided. Provide a name for your new project, initial source control type, work item process.

    On completion, the project summary displays. To learn more, see Share your project vision, view project activity.

    New Project TFS 2017

Important

When you create a project from the web portal, several process template files are ignored. Specifically, the files that would create a Report Manager site aren't supported. You can add reports later by following the instructions provided in Add reports to a teams project.

Creating a project from the web portal is supported for TFS 2015.2 and later versions. For earlier versions, use Team Explorer to create a project.

Important

When you create a project from the web portal, several process template files are ignored. Specifically, the files that would create a Report Manager site and a SharePoint project portal aren't supported. You can still set up Reporting and SharePoint manually after project creation.

If you want these features to be to be available, then create your project from Visual Studio/Team Explorer. For details, see Process template and plug-in files, Client support for project creation.

  1. If you have TFS 2015.2 or a later version, select the gear button to open the Projects page. Settings button (TFS Web Portal) Then choose New Project.

    Choose new project, horizontal navigation

    Otherwise, for TFS 2015 or TFS 2015.1, open the administration overview page by choosing the gear button. Settings button (TFS Web Portal) Then select Server settings and choose New project.

    New Project TFS 2017

    Select the collection administration page for the collection you want to create the project in from the left pane. Select Create a new project.

  2. Enter information into the form provided. Provide a name for your new project, a short description, and select its initial source control type and work item tracking process.

    Create new project form, tfs

Creating a project from the web portal isn't supported for TFS 2015 and earlier versions. Use Team Explorer to create a project.

List and connect to projects

Connect to a project, collection, or server from your web browser.

  1. To view the projects defined for an organization, select Azure DevOps to open the Projects page. Azure DevOps logo

  2. Choose the organization to view the list of projects. The page lists the last two or three projects you connected to at the top. Select any project to connect to that project.

    Open Projects

  3. Or, choose Organization settings and then select Projects to list all projects.

    Open Projects

    You can choose a project to open project settings for that project on this page. For more information, see About settings at the user, team, project, or organization-level. Or, you can rename a project or delete a project.

  1. To view the projects defined for a collection, select Azure DevOps to open the Projects page. Azure DevOps logo

  2. Choose the collection to view the list of projects. The page lists the last two or three projects you connected to at the top. Choose any project to connect to that project.

    Open Projects

  3. Or, select Admin settings and then choose Projects to list all projects.

    Open Projects

    You can choose a project to open project settings for that project on this page. For more information, see About settings at the user, team, project, or organization-level. Or, you can rename a project or delete a project.

Open the administration overview page by choosing the gear button and choose Collection settings. Settings button (TFS Web Portal)

Overview tab, Project list, Collection settings

You can choose a project to open project settings for that project on this page. For more information, see About settings at the user, team, project, or organization-level. Or, you can rename a project or delete a project.

Add a repository to your project

From the admin context of the web portal, you can add additional repositories to a project. Add either Git (distributed) or TFVC (centralized) repositories. You can create many Git repositories, but only a single TFVC repository for a project. Additional steps to address permissions may be required. For more information, see Use Git and TFVC repos in the same project.

  1. Select New repository.

    Create new repository

  2. Name the repository and select Create.

    Create new repository dialog

Add repositories to an existing project

Note

The ability to work from both Git and TFVC repositories from the same project is supported when you connect to TFS 2015.1 and later versions.

Next steps