Create a project in Azure DevOps and TFS

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

Create a project to establish a repository for source code, where a group of developers and teams can plan, track progress, and collaborate on building software solutions. Each project you create provides boundaries to isolate data from other projects and must be managed and structured to support your business needs. To learn more about projects and when or when not 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, and want to start coding an application project, then see one of the following topics: Set up Git on your dev machine or Develop your app in Team Foundation version control.

Note

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

Create a project from the web portal

To create a project, you must first have created an organization in Azure DevOps.

Important

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

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. If you want SQL Server Reporting Services to be to be available, then create your project from Visual Studio or Team Explorer. For details, see Process template and plug-in files, Client support for project creation.

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.

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

If you're not a member of the Project Collection Administrators Group, get added as one. To create projects you must have the Create new projects permission set to Allow.

Note

Your web portal uses either the New navigation or Previous navigation user interface. Choose the New navigation tab if the New Navigation feature is enabled. You'll see a vertical sidebar along with other navigational features when New Navigation has been enabled for the signed-in user or the organization. Choose Previous navigation when you see a top-level, blue-bar—indicating that New navigation isn't enabled. For more information, see Web portal navigation.

Note

Choose the New navigation tab for guidance. Azure DevOps Server 2019 supports the New Navigation user interface. For more information, see Web portal navigation.

Note

Choose the Previous navigation tab for guidance. TFS 2018 and earlier versions only support the previous navigation user interface. For more information, see Web portal navigation.

  1. Choose the Azure DevOps logo to open the Projects page, and then choose Create Project.

    Open Projects

  2. Enter information into the form provided. Provide a name for your project, and choose the visibility, initial source control type, work item process. For details on public projects, see Create a public project. If the Public option is grayed out, you need to change the policy.

    Create new project form, latest vsts

    See choosing the right version control for your project and choose a process for guidance.

  3. When your project has been created, the welcome page appears.

    Project creation confirmation dialog, new nav

    Select one of the following tasks to get started:

Choose the Previous navigation tab for guidance. New navigation isn't supported for TFS 2018 and earlier versions.

Create a project in Team Explorer

You can create a project from Team Explorer after you have connected to an on-premises server.

Note

For TFS 2018 and later versions, users are redirected to the web. They no longer are able to create a project from Visual Studio.

TFS 2018 and later versions no longer support native integration with SharePoint products. If you're planning to upgrade to TFS 2018, read About SharePoint integration to learn about the options available to you.

  1. If you're not a member of the Project Collection Administrators Group, get added as one. To create projects you must have the Create new projects permission set to Allow.

  2. 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 are supporting 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.

    • Has SQL Server Analysis Services and SQL Server Reporting Services been configured for the deployment? If so, ask your administrator to add you as a member of the Team Foundation Content Managers group on the server that hosts SQL Server Reporting Services. Without these permissions, you are unable to create a project.

    • Has a SharePoint Web application been configured for your deployment? If you want to configure a SharePoint portal when you create your project, ask the 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.

  3. Open the same version of Visual Studio as the version of TFS that you're connecting to. If you don't see the Team Explorer pane, open View>Team Explorer from the menu.

    As needed, Download and install Visual Studio Community to get a free copy of the latest version.

  4. Connect to the server and project collection where you want to create your project.

    ALM_CTP_Connect

    You can access Team Explorer for free by installing Visual Studio Community or any other Visual Studio version.

    You must connect from a client that is at the same version level as TFS. That is, you must connect to TFS 2015 from a version of Visual Studio 2015.

    ALM_EXL_Connect

    Tip: If you are running Team Explorer from a server that hosts SharePoint Products and SQL Server Reporting Services, you might need to run Visual Studio as an administrator.

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

    ALM_EXL_AddServer

  6. Open the New Project Wizard.

    New link on Connect page (Team Explorer)

  7. Name the project. Don't specify more than 64 characters.

    ALM_CTP_NameProject

  8. Choose a process template. For a comparison of the default process templates, see Choose a process.

    ALM_CTP_SelectTemplate

  9. Choose your version control, either Git distributed repositories or TFVC, one centralized repository.

    ALM_CTP_SelectSource

    Not sure which system to use? Learn more about Git or TFVC.

    After you've created your project, you can add repositories.

  10. Unless your project collection is configured to support a SharePoint project portal, you're done.

    ALM_CTP_Finish

    If the Next button is active, you can configure your project portal.

    If the wizard encounters a problem, you receive an error message and a link to the project creation log. Review the log file for specific errors and exceptions.

  11. When you're finished, you can see your project in Team Explorer. You can also choose the Web Access link to connect to your project from the web portal.

    Team Explorer Home page w/ TFVC as source control Team Explorer Home page with Git as source control

Create a project from the command line or scripts

You can create and retrieve projects and other objects from the command line or scripts using the CLI. Check out the CLI documentation to learn more.

Note

The CLI is supported for TFS 2017.2 and later versions.

Add a repository

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

Create new repository

Name the repository and choose 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