Rename a Git repository in your project

  • Article
  • 4 minutes to read

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015

You lot can rename a Git repository in a project from your spider web browser. Later you rename the repo, each member of your team should take a few steps to re-enable their dev machines to connect to the repo on the server.

Prerequisites

  • To rename a repository, you must accept Rename Repository permissions on your Git repo.
  • If you want to utilize az repos update control to rename a repository, be sure to follow the steps in Get started with Azure DevOps CLI.

Rename the repository

  • Browser
  • Azure DevOps CLI

  1. From the web portal, select Repos, Files.

    View your files

  2. From the repo drop-downward, select Manage repositories.

    Manage repositories

  3. Select the name of the repository from the Repositories list, cull the ... card, and so choose Rename repository.

    Rename repository

  4. Rename the repository by typing the repo's new name and selecting Rename.

    Rename repository confirm

    1. From the web portal, open the projection administration page for your project and select Version Control.

    Version control settings

  2. Select the repo you lot desire to rename under Git repositories on the left and select .... Select Rename repository... from the menu.

    Rename a repository

    Notation

    If the Repositories pane is not expanded, select > to expand it and brandish the listing of repositories.

    Repositories pane

  3. Enter a new repo name in the Repository proper name field in the dialog, then select Rename.

    Rename repository confirm

Update the Git remotes on your dev machines

Git uses remote references to fetch and button changes between your local copy of a repository and the remote version that is stored on the server. After a Git repository or project has been renamed, you should update your remote references. Update your references to that the remote repository URL contains the project and the repository name.

Each fellow member of your squad must update their local Git repos to continue connecting from their dev machines to the repo in the project. The instructions below show how to update the remotes for the Fabrikam Mobile repo that was renamed to Fabrikam.

Become the new URL for the repo

  1. Select Repos, Files.

    View your files

  2. Select Clone in the upper-right corner of the Files window and re-create the clone URL.

    Retrieve the clone URL

  • Select Clone in the upper-right corner of the Lawmaking window and copy the Clone URL.

    Retrieve the clone URL

Update your remote in Visual Studio

  1. Connect to the repo.

    Connect to the repository

  2. Open up the project settings.

    Project settings

  3. Open the repo settings.

    Repository settings

  4. Edit the fetch and push remote references and paste the URL that you lot copied from the remote repo.

    Edit remote

Update your remote in older versions of Visual Studio from the command prompt

If you use an older version of Visual Studio or work with Git from the command prompt:

  1. Open up the Git control prompt.

  2. Get to the local repository and update the remote to the URL y'all copied from the remote repo.

    git remote set-url origin {URL_you_copied_from_the_remote_repo}

Refresh Team Explorer

  1. Refresh Squad Explorer.

    Refresh Team Explorer

  2. Squad Explorer now shows the updated repo proper noun.

    Team Explorer Updated

Q&A

Q: Can I rename my repo again? Can I reuse an one-time repo name?

A: Yes

Q: What if I named my remote something other than the default origin?

A: If y'all're using:

  • Visual Studio 2015, and then edit the remote with the name y'all used.

  • An older version of Visual Studio or the command prompt, then run this control: git remote set-url {remote_name} {URL_you_copied_from_the_remote_repo}

  • Prepare Git repository settings and policies