Create a new Git repo

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

Visual Studio 2019 | Visual Studio 2022

A Git repository, or repo, tracks changes to files within a folder. You can create any number of local Git repos on your computer, each stored in its own folder. Each Git repo that you create is independent of other Git repos, so changes you make in one repo won't affect the others.

A Git repo stores every version of every file in the repo, unless you tell Git to ignore a file. Git saves file versions efficiently, so storing a large number of versions doesn't necessarily require a lot of disk space. Git supports comparing file versions, merging different versions, switching between versions, and much more. You can use Git to manage your source code, regardless of whether your code files are inside or outside of a Visual Studio solution. To share your work, you can connect your local Git repo to a remote Git repo that others can access. The remote repo can be an Azure Repos Git repo, a GitHub repo, or other hosted Git repo.

This article provides procedures for the following tasks:

• Create a local Git repo from a new solution
• Create a local Git repo from an existing solution
• Create a local Git repo in an empty folder
• Connect a local Git repo to an Azure Repos Git repo
• Connect a local Git repo to a GitHub repo

For an overview of the Git workflow, see Azure Repos Git tutorial.

Prerequisites

Category	Requirements
Project access	Member of a project.
Permissions	- View code in private projects: At least Basic access. - Clone or contribute to code in private projects: Member of the Contributors security group or corresponding permissions in the project. - Set branch or repository permissions: Manage permissions permissions for the branch or repository. - Change default branch: Edit policies permissions for the repository. - Import a repository: Member of the Project Administrators security group or Git project-level Create repository permission set to Allow. For more information, see Set Git repository permissions.
Services	Repos enabled.
Tools	Optional. Use az repos commands: Azure DevOps CLI.

Note

In public projects, users with Stakeholder access have full access to Azure Repos, including viewing, cloning, and contributing to code.

Create a local Git repo from a new solution

Visual Studio doesn't support creating a local Git repo when you create a new solution. Instead, create your Visual Studio solution, then follow the steps in Create a local Git repo from an existing solution.

Git command line doesn't support creating a new Visual Studio solution. Instead, create your new solution using Visual Studio, then follow the steps in Create a local Git repo from an existing solution.

---

Create a local Git repo from an existing solution

Create a local Git repo to track file changes in your existing Visual Studio solution.

Visual Studio 2022

Visual Studio 2022 provides a Git version control experience by using the Git menu, Git Changes, and through context menus in Solution Explorer. Visual Studio 2019 version 16.8 also offers the Team Explorer Git user interface. For more information, see the Visual Studio 2019 - Team Explorer tab.

1. In Solution Explorer, right-click the solution name, or right-click any item in the Folder view of Solution Explorer, and then select Create Git Repository. Or, choose Add to Source Control on the status bar in the lower right-hand corner of Visual Studio, and then select Git. If you don't see these options, then your code is already in a Git repo.

   

   Or, choose Git > Create Git Repository from the menu bar to launch the Create a Git repository window. If you don't see this option, then your code is already in a Git repo.

   

2. In the Create a Git repository window, choose Local only, verify the local path is correct, and then choose Create.

   

You've now created a local Git repo in the Visual Studio solution folder and committed your code into that repo. Your local Git repo contains both your Visual Studio solution and Git resources.

Visual Studio 2019 - Git menu

Visual Studio 2019 provides a Git version control experience by using the Git menu, Git Changes, and through context menus in Solution Explorer.

1. In Solution Explorer, right-click the solution name, or right-click any item in the Folder view of Solution Explorer, and then select Create Git Repository. Or, choose Add to Source Control on the status bar in the lower right-hand corner of Visual Studio, and then select Git. If you don't see these options, then your code is already in a Git repo.

   

   Or, choose Git > Create Git Repository from the menu bar to launch the Create a Git repository window. If you don't see this option, then your code is already in a Git repo.

   

2. In the Create a Git repository window, choose Local only, verify the local path is correct, and then choose Create.

   

You've now created a local Git repo in the Visual Studio solution folder and committed your code into that repo. Your local Git repo contains both your Visual Studio solution and Git resources.

Visual Studio 2019 - Team Explorer

Visual Studio 2019 version 16.8 and later versions provides a Git version control experience while maintaining the Team Explorer Git user interface. To use Team Explorer, uncheck Tools > Options > Preview Features > New Git user experience from the menu bar. You can use Git features from either interface interchangeably.

Note

One advantage of connecting to a project through Team Explorer is you gain access to the Work Items hub. For an overview of Team Explorer features, see Navigate in Visual Studio Team Explorer.

In Team Explorer, under Local Git Repositories, select New. Enter a local path and select Create.

Team Explorer doesn't launch the Create a Git repository window, and assumes you want a local Git repo.

You've now created a local Git repo in the Visual Studio solution folder and committed your code into that repo. Your local Git repo contains both your Visual Studio solution and Git resources.

Git Command Line

1. If you haven't already, download and install Git. When prompted during the install, enable Git Credential Manager.

2. At the command prompt, go to the root folder that contains your existing Visual Studio solution and run the following commands. These commands create a local Git repo in the Visual Studio solution folder and commit your code into that repo.

   Console

   > git init
   > git add .
   > git commit -m "first commit"
   > git branch -m main
   

Create a local Git repo in an empty folder

Visual Studio 2022

Visual Studio 2022 doesn't support creating a new local repo by using Team Explorer. Use Git Command Line.

Visual Studio 2019 - Git menu

Use the procedure in the Visual Studio 2019 - Team Explorer or use Git Command Line.

Visual Studio 2019 - Team Explorer

You can create a new local repo in an empty folder from Team Explorer.

1. Under Local Git Repositories in the Connect view of Team Explorer, choose New.

   

2. Enter a folder path where the repo will be created. The specified folder must be empty, or not exist. Choose Create.

   

3. You've now created a new local Git repo. To view the folder contents, right-click the new repo entry and select Open in File Explorer.

   

   Your new local Git repo only contains Git resources.

   

Git Command Line

1. If you haven't already, download and install Git. When prompted during the install, enable Git Credential Manager.

2. At the command prompt, go to the empty folder and run the following command to create a new local Git repo.

   Console

   > git init
   

3. When you've added files to the folder, add them to the Git repo by running the following commands.

   Console

   > git add .
   > git commit -m "first commit"
   > git branch -m main
   

Connect a local Git repo to an Azure Repos Git repo

You can share your code with others by connecting your local Git repo to an Azure Repos Git repo.

Visual Studio 2022

1. In Solution Explorer, right-click the solution name, or right-click any item in the Folder view of Solution Explorer and then select Push to Git service to launch the Create a Git repository window.

   

   Or, choose Git > Push to Git service from the menu bar to launch the Create a Git repository window.

   

2. Open a browser and navigate to your Azure DevOps project by using a URL in the form of https://dev.azure.com/<OrganizationName>/<ProjectName>. If you don't have a project yet, create one.

3. In your Azure DevOps project, create an empty Git repo without a README file. Copy the clone URL from the Clone Repository popup.

   

4. In the Create a Git repository window, choose Existing remote and enter the repo clone URL from the previous step, and then choose Push. For more information on how to create a new Azure DevOps repo, see Create a new Git repo in your project.

   

Visual Studio 2019 - Git menu

1. In Solution Explorer, right-click the solution name, or right-click any item in the Folder view of Solution Explorer and then select Push to Git service to launch the Create a Git repository window.

   

   Or, choose Git > Push to Git service from the menu bar to launch the Create a Git repository window.

   

2. Open a browser and navigate to your Azure DevOps project by using a URL in the form of https://dev.azure.com/<OrganizationName>/<ProjectName>. If you don't have a project yet, create one.
   

3. In your Azure DevOps project, create an empty Git repo without a README file. Copy the clone URL from the Clone Repository popup.

   

4. In the Create a Git repository window, choose Existing remote and enter the repo clone URL from the previous step, and then choose Push. For more information on how to create a new Azure DevOps repo, see Create a new Git repo in your project.

   

Visual Studio 2019 - Team Explorer

1. In the Push to Azure Dev Ops Services section of the Synchronization view in Team Explorer, select the Publish Git Repo button.

   
   
   

2. Choose your Azure DevOps account, organization, and a repo name, and then select Publish Repository.

   

   This step creates a new project in your Azure DevOps account with the same name that you selected for the repo. To create the repo in an existing project, select Advanced next to the Repository name, and then choose a project.

   Your code is now in a Azure Repos Git repo. You can view your code on the web by selecting See it on the web.

   

Git Command Line

Note

You can also create an Azure Repos Git repo from the command line by using the Azure CLI.

1. Open a browser and navigate to your Azure DevOps project using a URL in the form of https://dev.azure.com/<OrganizationName>/<ProjectName>. If you don't have a project yet, create one.

2. In your Azure DevOps project, create an empty Git repo without a README file. Copy the clone URL from the Clone Repository popup.

   

3. To publish your existing local git repository to Azure repos, run the following commands in the folder containing the local git repository using the clone URL from the previous step. If you don't have a local git repository yet, create one using the previous steps in this article.

   Console

   > git remote add origin <clone URL>
   > git status
   > git push -u origin main
   

   Your code is now published to the main branch of then Azure Repos Git repo.

Note

With Azure DevOps Services, the format for the project URL is dev.azure.com/{your organization}/{your project}. However, the previous format that references the visualstudio.com format is still supported. For more information, see Introducing Azure DevOps, Switch existing organizations to use the new domain name URL.

Connect a local Git repo to a GitHub repo

You can also share your code with others by connecting your local Git repo to a GitHub repo.

Visual Studio 2022

1. In Solution Explorer, right-click the solution name, or right-click any item in the Folder view of Solution Explorer, and then select Push to Git service to launch the Create a Git repository window.

   

   Or, choose Git > Push to Git service from the menu bar to launch the Create a Git repository window.

   

2. In the Create a Git repository window, choose GitHub, select your GitHub account, owner name, and a new repo name, and then choose Push.

   

   This step creates a new repo in your GitHub account with content from your local repo.

Visual Studio 2019 - Git menu

1. In Solution Explorer, right-click the solution name, or right-click any item in the Folder view of Solution Explorer, and then select Push to Git service to launch the Create a Git repository window.

   

   Or, choose Git > Push to Git service from the menu bar to launch the Create a Git repository window.

   

2. In the Create a Git repository window, choose GitHub, select your GitHub account, owner name, and a new repo name, and then choose Push.

   

   This step creates a new repo in your GitHub account with content from your local repo.

Visual Studio 2019 - Team Explorer

1. In the Publish to GitHub section of the Synchronization view in Team Explorer, select your GitHub account, owner name, and a new repo name, and then choose Publish.

   

   This step creates a new repo in your GitHub account with content from your local repo.

Git Command Line

Note

You can also create a GitHub repo from the command line by using the GitHub CLI.

1. Open a browser and navigate to your GitHub account. If you don't have a GitHub account yet, create one.

2. In your GitHub account, create an empty Git repo without added files. Copy the clone URL from the Quick setup page.

   

3. To publish your local commit to GitHub, run the following commands at the command prompt in your local git repo folder, using the clone URL from the previous step.

   Console

   > git remote add origin <clone URL>
   > git push -u origin main
   

   Your code is now published to the main branch of your GitHub repo.

Next steps

Save work with commits

Related articles

• New to Git repos? Learn more