Introduction
A git remote is a connection to a repository hosted on a remote server – GitHub, BitBucket, GitLab or any other remote location. If you collaborate with a team on a larger project, it is often useful to create more than one git remote.
However, as the project progresses, the remote repository may move to another host or a member of the team may stop working on the project. The particular remote is then no longer needed.
In this tutorial you will you will learn how to remove a git remote from your repository.
Prerequisites
- Access to the command line
- A Git project
- Git installed and configured (See our guides on Installing Git on Windows, Installing Git on Mac, How to Install Git on Ubuntu, and How to Install Git on CentOS)
Option 1: Remove a Git Remote Using Command Line
1. To delete a git remote using the command line, first cd
into the directory of the repository which contains the remote:
2. To list the available remotes and their URLs in the folder, type git remote -v
:
3. Delete a remote with the following command:
git remote remove [remote name]
4. The command will not give you any feedback. Use git remote -v
to confirm the removal:
Note: If you are using Git version 1.7.10 or older, use git remote rm [remote name]
.
Option 2: Remove a Git Remote by Editing the Configuration File
The git remote remove
command does not delete the repository. Instead, it removes entries about the remote from the .git/config file.
Using the command line is the recommended way of removing a remote. However, you can also remove it by editing the .git/config configuration file.
1. To do this, open the file in a text editor (we’ll be using Vim):
vi .git/config
2. Search the file for the entry belonging to the remote you wish to remove.
3. Delete the entry, then save the file and exit.
Remove the origin Remote
Origin is often the only remote you see in a project. It is the default pointer to the repository you cloned.
If you wish to remove the origin remote, use the same git remote remove
command:
git remote remove origin
Conclusion
This article explained how to remove a git remote repository from your machine, using the command line or by editing the .git/config file.
You might also be interested in learning how to delete a remote or local Git branch or download a copy of our free Git Cheat Sheet.
Next you should also read
SysAdmin,DevOps and Development
How to Delete a Git Branch Remotely and Locally
October 13, 2020
This article provides a quick overview of basic commands and processes necessary for deleting both local and…
SysAdmin,DevOps and Development
September 15, 2020
Unstaging in Git means removing queued changes from the index. This guide covers several different ways to…
SysAdmin,DevOps and Development
March 10, 2020
Git, the popular version control system, has a plethora of commands for managing your project history. This…
SysAdmin,DevOps and Development
February 3, 2020
Developers need to switch between branches frequently. Git branches allow you to work on your code, fix bugs,…
Author
Marko Aleksic
Marko Aleksić is a Technical Writer at phoenixNAP. His innate curiosity regarding all things IT, combined with over a decade long background in writing, teaching and working in IT-related fields, led him to technical writing, where he has an opportunity to employ his skills and make technology less daunting to everyone.