Edit

Create a project in Azure DevOps

  • Article

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

Create an Azure DevOps project to establish a repository for source code and to plan and track work. You can manage and structure your project to support your business needs. Each project provides boundaries to isolate data from other projects. For more information, see About projects and scaling your organization.

Important

Select a version from Azure DevOps Content Version selector.

Select the version of this article that corresponds to your platform and version. The version selector is above the table of contents. Look up your Azure DevOps platform and version.

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

Note

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

Prerequisites

Important

To create a public project or to make a private project public, see the information in Make a private project public. You must enable additional policy settings to work with public projects. Then, return to this article to create your project.

Create a project

You can create up to 1000 projects within an organization in Azure DevOps. For more information, see Work tracking, process, and project limits.

Important

When you create a project from the web portal, Azure DevOps ignores several process template files. 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.

There isn't a limit on the number of projects that you can create within a project collection, however for performance purposes, we recommend you limit the number to 300 or fewer. For more information, see Work tracking, process, and project limits.

  1. Sign in to your organization (https://dev.azure.com/{yourorganization}).

  2. Select New project.

    Screenshot of listed projects and highlighted New projects button.

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

    Screenshot of create new project form.

    When you choose public visibility, anyone on the internet can view your project. With private visibility, only users you give access to can view your project. For more information about features and access levels for public projects, see Make a private project public. If the Public option isn't available, you need to change the policy.

  4. Select Create. Azure DevOps displays the project welcome page.

    Screenshot of project creation confirmation dialog.

    Select one of the following options to continue:

  1. Sign in to your organization (https://dev.azure.com/{yourorganization}).

  2. Select New project.

    Screenshot of listed projects and highlighted New projects button.

  3. 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 About processes and process templates.

    Screenshot of create new project form.

    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.

  4. Select Create. Azure DevOps displays the welcome page.

    Screenshot of project creation confirmation dialog.

    Select one of the following options to continue:

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

    Screenshot of highlighted New Project button.

  2. Enter a name for your new project, initial source control type, and work item process.

    Azure DevOps displays the project summary. For more information, see Share your project, view project activity.

    Screenshot of new project created.

List projects

View a list of projects from your web browser.

  1. Sign in to your organization (https://dev.azure.com/{yourorganization}).

  2. Select Organization settings and then select Projects.

    Screenshot of highlighted Project button and resulting list.

    Open your desired project. For more information, see About settings at the user, team, project, or organization-level.

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

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

    Screenshot of projects list.

Or

  1. Select Admin settings and then choose Projects to list all projects.

    Screenshot of selected Admin settings and 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.

Add a repository to your project

You can add Git (distributed) or TFVC (centralized) repositories to your project. You can create many Git repositories, but only a single TFVC repository for a project. More steps to address permissions may be required. For more information, see Use Git and TFVC repos in the same project.

Next steps

Structure your project

Frequently asked questions (FAQs)

A: If you receive an error message that states you don't have permission to create a project, you need to request organization-level permissions. See Change permissions at the organization- or collection-level.

A: If you receive an error message that states you don't have permission to create a project, you need to request collection-level permissions. See Change permissions at the organization or collection-level. If you have SQL Reporting Services installed in the collection, you also need permissions for reports to the Team Foundation Content Managers group.

Q: How do I resolve Error TF30321?

A: Error TF30321: The name you entered is already used for another project on the Team Foundation Server indicates that you should use a different name for your project. The name you entered is either in active use or has undergone partial deletion, but not full deletion.

Even when you've deleted a project, you may get the same name error. Some components could be created or deleted even though others aren't. In this event, you can't reuse the name associated with the project.

To verify project deletion or remove remaining components associated with a partially deleted project, use the Delete project command line tool(TFSDeleteProject). Then try again to create the project with the same name.

Even with troubleshooting, you might not be able to use the same name. Some components of the deleted project could be scheduled for deletion but not yet deleted.

A: The process template used to create the project contains several XML plug-in files. If one of these files contains a format or other error, an error message appears.

Review the project creation log to determine the plug-in that caused the error. After you discover the problem, you can either contact the developer or vendor that provided the plug-in, or attempt to fix the problem yourself. For more information, see Customize a process template.

Q: How do I resolve a problem connecting to a server?

A: If you receive an error message about a problem connecting to a server, retrieving information from a server, or checking permissions to create projects, an incorrectly configured server in the deployment could have caused it. This problem is especially common after a server move, failover, or other maintenance activity.

Contact the TFS system administrator and request that they verify the server configuration.

Q: How do I add my custom process template to the list?

A: Upload your template using the Process Template Manager. For more information, see Customize process.

Q: Where is the log file located?

A: The log file is stored in $:\Users\user name\AppData\Local\Temp and labeled vso_TeamProjectCreation_yyyy_mm_dd_hh_mm_ss.log.

The log shows each action taken by the wizard at the time of the failure and may include more details about the error. You can review the log entries to find network or file related issues by searching for Exception or Error.

Q: How do I add SQL Server Reporting services?

A: See Add reports to a project.