Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013
Important
Creating a project from the web portal isn't supported for Team Foundation Server (TFS 2015) and earlier versions. Use Team Explorer to create a project.
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.
Important
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 whether you are working from Azure DevOps Services or an on-premises version of Azure DevOps Server, renamed from Team Foundation Server (TFS).
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.
You must be a member of the Project Collection Administrators group or have the Create new projects permission set to Allow. If you're the Organization Owner, you're automatically added to the Project Collection Administrators group. If you aren't a member, get added now. For more information, see Set permissions at the project- or collection-level.
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. If you aren't a member, get added now. For more information, see Set permissions at the project- or collection-level.
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. If you aren't a member, get added now. For more information, see Set permissions at the project- or collection-level.
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.
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.
Choose the organization, and then select New project.
Enter information into the form provided. Provide a name for your project. 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. Enter an optional description. Choose the visibility, initial source control type, and work item process. For more information, see Choosing the right version control for your project and Choose a process.
Select visibility of either public or private. When 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 more information about public projects, see Create a public project in your organization. If the Public option isn't available, you need to change the policy.
Choose the Current page tab for information on creating a project.
Select Azure DevOps to open the Projects page.
Choose the organization, and then select Create project.
Enter information into the form provided. Provide a name for your project. 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. Enter an optional description. Choose the visibility, initial source control type, and work item process. For more information, see Choosing the right version control for your project and Choose a process.
Select your project visibility of either public or private. When 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 more information about public projects, see Create a public project in your organization. If the Public option isn't available, you need to change the policy.
Select Azure DevOps to open the Projects page. Then, select Create project.
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.
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 have TFS 2015.2 or a later version, select the gear button to open the Projects page.
Then choose New project.
Otherwise, for TFS 2015 or TFS 2015.1, open the administration overview page by choosing
settings. Then, select Server settings and choose New project.
Select the collection administration page for the collection you want to create the project in from the left pane. Select Create a new project.
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.
For Azure DevOps Server 2020, you can use the following command to set the default server instance, collection, and project. az devops configure --defaults organization=https://ServerName/CollectionName project=ContosoWebApp
Parameters
name: Required. Name of the project to create.
description: Optional. Short description of the project. Enclose the description in quotes.
open: Optional. Once the command creates a project, it opens in the default web browser.
org: Optional. Azure DevOps organization URL. Required if not configured as default or picked up by using git config. You can configure the default organization using az devops configure -d organization=ORG_URL. Example: https://dev.azure.com/MyOrganizationName/.
process: Optional. The process model to use, such as Agile, Basic, Scrum, CMMI, or other custom process model. Agile is the default. To learn more, see About process customization and inherited processes.
source-control: Optional. Type of source control repository to create for the project: git (default) or tfvc. If not, name or ID of the project. Example: --project "Fabrikam Fiber".
The following command creates a new project named MyFirstProject under the Fabrikam organization. The project has the Agile process, and git source control. For other output format options, see Output formats for Azure CLI commands.
az devops project create --name MyFirstProject --description "Test project 1" --org https://dev.azure.com/fabrikam/ --process Agile --source-control git --output table
ID Name Visibility Process Source Control
------------------------------------ --------------- ------------ --------- ----------------
be87c31a-fbb3-4377-b207-57a8caf65e31 MyFirstProject1 Private Agile Git
Azure DevOps CLI commands aren't supported for Azure DevOps Server 2019 and earlier versions.
You can't create a project from Team Explorer for TFS-2018 and later versions, including Azure DevOps Services.
You can create a project from Visual Studio/Team Explorer after you've connected to an on-premises Azure DevOps Server.
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, select View > Team Explorer from the menu.
Connect to the server and project collection where you want to create your project.
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.
Tip
If you run Team Explorer from a server that hosts SharePoint Products and SQL Server Reporting Services, you might need to run Visual Studio as an administrator.
If it's your first time connecting to TFS, you need to add TFS to the list of recognized servers.
Open the New Project Wizard.
Name the project. Don't specify more than 64 characters.
Choose a process template. For a comparison of the default process templates, see Choose a process.
Choose your version control, either Git distributed repositories or TFVC, one centralized repository.
Unless your project collection supports a SharePoint project portal, you're done.
If the Next button is active, you can configure your project portal.
If you have a problem, you receive an error message and a link to the project creation log. See Troubleshoot creating a project for specific errors and exceptions.
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.
Note
For TFS 2018 and later versions, use the web portal. Creating a project from Visual Studio/Team Explorer is not supported for TFS 2018 and later versions, including Azure DevOps Server 2019 and Azure DevOps Services.
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.
Connect to a project, collection, or server from your web browser.
To view the projects defined for an organization, select Azure DevOps to open the Projects page.
Choose the organization to view the list of projects. The page lists the last two or three projects you connected to at the upper screen. Select any project to connect to that project.
Or, choose Organization settings and then select Projects to list all projects.
Choose the Current page tab for information on connecting to projects.
Connect to a project, collection, or server from your web browser.
To view the projects defined for an organization, select Azure DevOps to open the Projects page.
Choose the organization to view the list of projects. The page lists the last two or three projects you connected to at the upper screen. Select any project to connect to that project.
Or, choose Organization settings and then select Projects to list all projects.
To view the projects defined for a collection, select Azure DevOps to open the Projects page.
Choose the collection to view the list of projects. The page lists the last two or three projects you connected to at the upper screen. Choose any project to connect to that project.
Or, select Admin settings and then choose Projects to list all projects.
org: Optional. Azure DevOps organization URL. You can configure the default organization using az devops configure -d organization=ORG_URL. Required if not configured as default or picked up via git config. Example: https://dev.azure.com/MyOrganizationName/.
skip: Optional. Number of results to skip.
top: Optional. Maximum number of results to list.
Note
For Azure DevOps Server 2020, you can use the following command to set the default server instance, collection, and project. az devops configure --defaults organization=https://ServerName/CollectionName project=ContosoWebApp
Example
The following command lists the projects defined under the Fabrikam organization. For other output format options, see Output formats for Azure CLI commands.
az devops project list --org https://dev.azure.com/fabrikam/ --output table
ID Name Visibility
------------------------------------ ------------------ ------------
647c53b6-01aa-462a-adb7-da81d5620167 Agile 11 Private
c5dd744a-574b-4308-925f-386415dc6efc CMMI Private
d4195a58-96a9-4753-bbf9-4c0a4ef178e0 Demo 11 Private
80bb92c7-49b2-43db-9843-3baf8f64b85d Design Agile Private
5444a5d2-6bd9-4ad1-a25d-eea59855c2a9 Fabrikam Fiber Private
36946972-3a77-4bb4-875e-2f66a0f4652c Fabrikam Test Private
29bb9642-45f2-42bf-b391-f8701999c5fc My Basic Project Private
7aafdbeb-8de1-4e84-978f-d0ee4595b90e MyFirstProject Private
aba0ed07-3174-4793-9f2c-d2c5fa6b44d7 MyPublicProject Public
36ca09d1-9de0-4e3e-8277-e10b5cb96f7c Scrum 2.0 Private
Show project information, and open in web portal
You can list project information and optionally open the project in the web portal using the az devops project show command.
az devops project show --project
[--open]
[--org]
Parameters
project: Required. Name or ID of the project. Example: --project "Fabrikam Fiber".
open: Optional. Open the project in the default web browser.
org: Optional. Azure DevOps organization URL. You can configure the default organization using az devops configure -d organization=ORG_URL. Required if not configured as default or picked up by using git config. Example: https://dev.azure.com/MyOrganizationName/.
Note
For Azure DevOps Server 2020, you can use the following command to set the default server instance, collection, and project. az devops configure --defaults organization=https://ServerName/CollectionName project=ContosoWebApp
Example
The following command lists information for MyFirstProject under the Fabrikam organization and opens it in the web portal. For other output format options, see Output formats for Azure CLI commands.
az devops project show --project MyFirstProject --open --org https://dev.azure.com/fabrikam/ --output table
ID Name Visibility Process Source Control
------------------------------------ -------------- ------------ ----------------- ----------------
40751c1d-236b-418d-9df4-d5cc7c0e7bd6 MyFirstProject Private Scrum - Inherited Git
Azure DevOps CLI commands aren't supported for Azure DevOps Server 2019 and earlier versions.
From Team Explorer, you can view a list of projects by connecting to an organization or server. For more information, see Connect to a project.
Visual Studio 2019
Visual Studio 2017
Visual Studio 2015
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.
Select New repository.
Name the repository and select Create.
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.