Create a project

VSTS | TFS 2018 | TFS 2017 | TFS 2015 | TFS 2013

You add another project to establish a repository for source code and a place for a group of developers and teams to plan, track progress, and collaborate on building software solutions. Each project you add 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 add one, see About projects and scaling your organization.

Note

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

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.

Add a project from the web portal

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

Choose Previous navigation when you see a top-level, blue-bar. Choose New navigation if you see a vertical sidebar or if you enabled the New Navigation preview feature. The vertical sidebar along with other navigational features are enabled when the New Navigation preview feature has been enabled for the signed-in user or the VSTS organization. To learn how to use the web portal effectively, see Navigation Basics.

For on-premises TFS users, choose Previous Navigation for guidance.

  1. Choose the VSTS icon to open the Projects page, and then choose Create Project.

    Open Projects

  2. Fill out the form provided. Provide a name for your new project, select its initial source control type, select a process, and choose with whom to share the project.

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

    Create new project form, latest vsts

New navigation isn't supported on TFS at this time. Choose Previous navigation for guidance.

Add a project from 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 will be redirected to the web. They will no longer be 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 you should 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 work in an enterprise organization and will be supporting hundreds of projects, you should add all your projects to 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'll be 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'll need to add TFS to the list of recognized servers.

    ALM_EXL_AddServer

  6. Open the New Team 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 repo.

    ALM_CTP_SelectSource

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

    After you've created your project, you canadd 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'll 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

Add a project from the command line or scripts

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

Note

The VSTS CLI is supported for TFS 2017.2 and later versions.

Try this next

Once you've added a project, you'll have a default repository in which to add code. You'll want to add team members and structure your project to support your business needs. See these resources:

Add repositories

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