Skip to content

delete-existing-repo.md

Latest commit

 

History

History
104 lines (69 loc) · 3.99 KB

delete-existing-repo.md

File metadata and controls

104 lines (69 loc) · 3.99 KB
title Delete a Git repo from your project
titleSuffix Azure Repos
description Remove an existing Git repo in an Azure DevOps Services or Team Foundation Server project
ms.assetid 271f8473-e77d-4a95-80d9-0bd347de7533
ms.service azure-devops-repos
ms.topic how-to
ms.date 03/31/2022
monikerRange <= azure-devops
ms.subservice azure-devops-repos-git

Delete a Git repo from your project

[!INCLUDE version-lt-eq-azure-devops]

Remove unused Git repos from your project when they are no longer needed. The steps in this article show how to delete a Git repo from your Azure DevOps project. If you want to delete the entire project, see Delete a project.

Important

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

Prerequisites

Category Requirements
Permissions Delete Repository permission.

::: moniker range="azure-devops"

Note

To use the Azure DevOps CLI az repos delete command, see Get started with Azure DevOps CLI. ::: moniker-end

Delete a Git repo from the web

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.

Browser

::: moniker range="<=azure-devops"

  1. Select Repos, Files.

    View your branches

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

    Manage repositories

  3. Select the name of the repository from the Repositories list, choose the ... menu, and then choose Delete repository.

    Delete repository

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

    Delete repository confirm

::: moniker-end

Azure DevOps CLI

::: moniker range="azure-devops"

You can use Azure DevOps CLI to delete an Azure DevOps Git repository.

az repos delete --id
                     [--detect {false, true}]
                     [--org]
                     [--project]
                     [--subscription]
                     [--yes]

Parameters

Parameter Description
id ID of the repository. You can get the repository ID by running az repos list.
detect Automatically detect organization. Accepted values: false, true.
org, organization Azure DevOps organization URL. You can configure the default organization by using az devops configure -d organization=<ORG_URL>. Required if not configured as default or picked up via git config. Example: https://dev.azure.com/MyOrganizationName/.
project, p Name or ID of the project. You can configure the default project using az devops configure -d project=<NAME_OR_ID>. Required if not configured as default or picked up via git config.
subscription Name or ID of subscription. You can configure the default subscription using az account set -s <NAME_OR_ID>.
yes Don't prompt for confirmation.

Example

The following command deletes the Fabrikam repository, ID 0d58f562-4a10-495d-94d7-7ac61a22d7cc. This example uses the following default configuration: az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".

az repos delete --id  0d58f562-4a10-495d-94d7-7ac61a22d7cc
Are you sure you want to delete this repository? (y/n): y

::: moniker-end

::: moniker range="< azure-devops" [!INCLUDE temp] ::: moniker-end