Delete a Git repo from your team project

VSTS | TFS 2018 | TFS 2017 | TFS 2015

Remove unused Git repos from your team project when they are no longer needed.

Tip

Consider renaming the repo and locking its default branch instead of removing it. The commit history of the repo will be lost when it is deleted.

Important

You cannot remove a repo if it is the only Git repo in the Project. If you need to delete the only Git repo in a Project, create a new Git repo first, then delete the repo.

You must have Delete Repository permissions to delete a repo from a team project.

Note

The steps in this article show how to delete a Git repo from your team project. If you want to delete the entire team project, see Delete a team project.

Delete a Git repo from the web

  1. Select the settings icon in the web to bring up the project administration page and choose Version Control.

    Version control settings

  2. Select the Git repository to remove from the list shown and select the ... next to the name. Choose Delete Repository.

    remove the VSTS repo using the ellipses link next to the repo name

    Note

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

    Repositories pane

  3. Confirm the deletion of the repository by typing the repo's name and selecting Delete.