Create a project in Azure DevOps

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. You can manage and structure each project to support your business needs. Each project you create provides boundaries to isolate data from other projects. To learn more about projects and when to create one, see About projects and scaling your organization.


Select a version from TFS Content Version selector.

To view the content available for your platform, make sure that you select the correct version of this article from the version selector which is located above the table of contents. Feature support differs depending on the on-premises version of TFS you are using. .
To learn which on-premises version you are using, see What platform/version am I using?

If you don't want to create a project in Azure DevOps, you can create Azure DevOps Projects.


If you don't want to manage an on-premises server, you can sign up for Azure DevOps Services and create a project.


  • You create a project within a project collection. If you haven't created a project collection yet, do that now. For more information, 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. For more information, see Change project collection-level permissions.

  • Ask your 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.

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

Create a project

List and connect to projects

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

Next steps