| title | titleSuffix | description | ms.assetid | ms.service | ms.topic | ms.date | monikerRange | ms.subservice |
|---|---|---|---|---|---|---|---|---|
Clone an existing Git repo |
Azure Repos |
Learn how to create a local clone of any remote Git repo using Visual Studio or the Git command line. |
b6240e2f-2d3d-4874-9953-7e554d5e3b97 |
azure-devops-repos |
tutorial |
10/19/2022 |
<= azure-devops |
azure-devops-repos-git |
[!INCLUDE version-lt-eq-azure-devops] [!INCLUDE version-vs-gt-eq-2019]
You can create a local copy of a remote Git repo by cloning it into a local folder on your computer. Cloning a remote repo downloads all commits on all branches of the repo, unless you use the --single-branch clone option. Cloning links each branch in your new local repo with the corresponding branch in the remote repo. That way, when you push to share your local branch changes with your team, the corresponding remote branch is updated. Similarly, when you pull to update your local branch with changes made by your team, updates from the corresponding remote branch are retrieved. 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:
[!div class="checklist"]
- Get the clone URL for an Azure Repos Git repo
- Get the clone URL for a GitHub repo
- Clone an Azure Repos Git repo
- Clone a GitHub repo
- Clone any Git repo
- Open a Visual Studio solution from a cloned repo
For an overview of the Git workflow, see Azure Repos Git tutorial.
[!INCLUDE azure-repos-prerequisites]
Typically, you need to know the clone URL of the remote repo that you want to clone. The clone URL uniquely identifies the remote repo.
Note
When you're signed into an Azure DevOps project, Visual Studio supports searching for and cloning project repos without needing to know the clone URL.
-
From your web browser, open the team project for your Azure DevOps organization, and then choose Repos > Files to open the Files view.
:::image type="content" source="media/clone/visual-studio-2019/common/repos-files.png" border="true" alt-text="Screenshot of the Azure DevOps project page." lightbox="media/clone/visual-studio-2019/common/repos-files-lrg.png":::
-
In the Files view, choose Clone to launch the Clone Repository popup.
:::image type="content" source="media/clone/visual-studio-2019/common/azure-repo.png" border="true" alt-text="Screenshot of the Clone button on the Azure DevOps repo page." lightbox="media/clone/visual-studio-2019/common/azure-repo-lrg.png":::
-
Copy the clone URL from the Clone Repository popup.
:::image type="content" source="media/clone/visual-studio-2019/common/azure-clone-repo.png" border="true" alt-text="Screenshot of the 'Clone Repository' popup on the Azure DevOps project site." lightbox="media/clone/visual-studio-2019/common/azure-clone-repo-lrg.png":::
[!INCLUDE project-urls]
Typically, you need to know the clone URL of the remote repo that you want to clone. The clone URL uniquely identifies the remote repo.
Note
When you're signed into GitHub, Visual Studio supports searching for and cloning GitHub repos without needing to know the clone URL.
-
Open a browser and navigate to your GitHub account, select the Repositories tab, and choose the repository to clone.
:::image type="content" source="media/clone/visual-studio-2019/common/github-repo.png" border="true" alt-text="Screenshot of the repository page on the GitHub site." lightbox="media/clone/visual-studio-2019/common/github-repo-lrg.png":::
-
On the GitHub repository page, choose Code to launch the Clone popup. Copy the clone URL from the Clone popup.
:::image type="content" source="media/clone/visual-studio-2019/common/github-clone-repo.png" border="true" alt-text="Screenshot of the Clone popup on the page on the GitHub site." lightbox="media/clone/visual-studio-2019/common/github-clone-repo-lrg.png":::
By signing in as a member of an Azure DevOps project, you can clone private repos that are accessible to you, and public repos. Visual Studio supports search, clone, and sync operations on repos that are accessible through authentication.
Note
You can clone a public Azure Repos Git repo without signing in as a member of its parent Azure DevOps project. To clone a public Git repo without signing in, see Clone any Git repo and then connect to a project in Azure DevOps.
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.
[!INCLUDE Clone an Azure Repos Git repo]
Visual Studio 2019 provides a Git version control experience by using the Git menu, Git Changes, and through context menus in Solution Explorer.
[!INCLUDE Clone an Azure Repos Git repo]
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.
-
In Team Explorer, select Connect to open the Connect page, and then choose Manage Connections > Connect to Project.
:::image type="content" source="media/clone/visual-studio-2019/team-explorer/manage-connections.png" border="true" alt-text="Screenshot of the 'Connect to a Project' link in Team Explorer in Visual Studio 2019." lightbox="media/clone/visual-studio-2019/team-explorer/manage-connections-lrg.png":::
-
In the Connect to a Project window, sign in to Azure DevOps and choose the remote repo you want to clone. You can use the search box to filter the list of remote repos. If you don't see the remote repo, select Add Azure DevOps Server to add the server that hosts the repo. Verify the local folder path where you want the local clone to be created, and then select Clone.
:::image type="content" source="media/clone/visual-studio-2019/team-explorer/connect-add-server.png" border="true" alt-text="Screenshot of the 'Connect to a Project' window in Visual Studio 2019." lightbox="media/clone/visual-studio-2019/team-explorer/connect-add-server-lrg.png":::
After you've cloned a remote Git repo, Visual Studio detects the local clone and adds it to the list of Local Repositories in the Git menu.
:::image type="content" source="media/clone/visual-studio-2019/common/local-repositories.png" border="true" alt-text="Screenshot of the 'Local Repositories' option in the Git menu in Visual Studio 2019." lightbox="media/clone/visual-studio-2019/common/local-repositories-lrg.png":::
To clone an Azure Repos Git repo from the command line, see Clone any Git repo.
By signing into GitHub or using SSH authentication, you can clone private repos that are accessible to you, and public repos. Visual Studio supports search, clone, and sync operations on repos that are accessible through authentication.
Note
You can clone a public GitHub repo without signing in to GitHub or otherwise authenticating. To clone a public Git repo without signing in, see Clone any Git repo.
[!INCLUDE Clone a GitHub repo]
[!INCLUDE Clone a GitHub repo]
To clone a GitHub repo using Team Explorer, see Clone any Git repo.
To clone a GitHub repo from the command line, see Clone any Git repo.
Note
You can also clone a GitHub repo from the command line by using the GitHub CLI.
You can clone any Git repo that's accessible to you by using the clone URL of the repo.
[!INCLUDE Clone any Git repo]
[!INCLUDE Clone any Git repo]
-
In Team Explorer, select Connect to open the Connect page, and then choose Clone under Local Git Repositories.
:::image type="content" source="media/clone/visual-studio-2019/team-explorer/connect-clone.png" border="true" alt-text="Screenshot of the Clone link in the Connect view of Team Explorer in Visual Studio 2019." lightbox="media/clone/visual-studio-2019/team-explorer/connect-clone-lrg.png":::
-
Enter the clone URL of the remote Git repo that you want to clone, verify the local folder path where you want to create the local clone, and then choose Clone. To clone the remote Git repo and any Git repos that are nested within it, leave Recursively Clone Submodules checked.
:::image type="content" source="media/clone/visual-studio-2019/team-explorer/clone-remote-repo.png" border="true" alt-text="Screenshot of the Clone options in the 'Local Git Repositories' section of the 'Team Explorer' Connect view in Visual Studio 2019." lightbox="media/clone/visual-studio-2019/team-explorer/clone-remote-repo-lrg.png":::
After you've cloned a remote Git repo, Visual Studio detects the local clone and adds it to the list of Local Repositories in the Git menu.
:::image type="content" source="media/clone/visual-studio-2019/common/local-repositories.png" border="true" alt-text="Screenshot of the 'Local Repositories' option from the Git menu in Visual Studio 2019." lightbox="media/clone/visual-studio-2019/common/local-repositories-lrg.png":::
-
If you haven't already, download and install Git. Enable Git Credential Manager when prompted during the install, or configure SSH authentication.
-
At the command prompt, run the Git clone command with the clone URL of the remote repo. This command will create a local clone repo under the current folder.
git clone <clone URL>The Git clone command also let's you specify a folder path after the clone URL to create the repo in a specific location. For example:
git clone https://fiber-teams@dev.azure.com/fiber-teams/FiberTests/_git/FiberTests C:\Repos\FiberTestsThe Git clone command also let's you clone just a single branch. This option is useful when only one branch of a large repo is of interest to you.
git clone <clone URL> --branch <branch name> --single-branchNote
When you clone a remote repository, Git assigns the alias origin as shorthand for the URL of the remote repo you cloned. Git commands often use that alias.
[!INCLUDE Open a Visual Studio solution from a cloned repo]
[!INCLUDE Open a Visual Studio solution from a cloned repo]
-
Right-click on a repository in the Connect view of Team Explorer and choose Open.
:::image type="content" source="media/clone/visual-studio-2019/team-explorer/open-cloned-repo.png" border="true" alt-text="Screenshot of cloned repos in the 'Local Git Repositories' section of Team Explorer in Visual Studio 2019." lightbox="media/clone/visual-studio-2019/team-explorer/open-cloned-repo-lrg.png":::
-
In the Home view of Team Explorer, double-click your solution file under Solutions.
:::image type="content" source="media/clone/visual-studio-2019/team-explorer/open-solution-from-cloned-repo.png" border="true" alt-text="Screenshot of the solution file in the Solutions section of Team Explorer in Visual Studio 2019." lightbox="media/clone/visual-studio-2019/team-explorer/open-solution-from-cloned-repo-lrg.png":::
-
The Visual Studio solution that you selected is now open in Solution Explorer.
:::image type="content" source="media/clone/visual-studio-2019/team-explorer/open-solution-explorer.png" border="true" alt-text="Screenshot of an open solution within 'Solution Explorer' in Visual Studio 2019." lightbox="media/clone/visual-studio-2019/team-explorer/open-solution-explorer-lrg.png":::
At the command prompt, run the following command to open a Visual Studio solution from a cloned repo. This command isn't a Git command.
start <solution filepath>For example:
start C:\Repos\FiberTests\FiberTests.sln[!div class="nextstepaction"] Save work with commits