How to Remove Remote in Git: Simple Commands Explained

To remove a remote in Git, use the command git remote remove <remote-name>. This deletes the reference to the remote repository from your local Git configuration.

Syntax

The command to remove a remote in Git follows this pattern:

• git remote remove <remote-name>: Removes the remote named <remote-name> from your local repository.

Here, <remote-name> is the name of the remote you want to delete, like origin or upstream.

bash

git remote remove <remote-name>

Example

This example shows how to remove a remote named origin from your Git repository.

bash

git remote -v
# Shows current remotes

# Remove the remote named 'origin'
git remote remove origin

# Verify removal
git remote -v

Output

origin	[e-mail]:user/repo.git (fetch)
origin	[e-mail]:user/repo.git (push)

# After removal, no output from 'git remote -v' if no other remotes exist

Common Pitfalls

Common mistakes when removing remotes include:

• Using the wrong remote name, which causes Git to show an error like error: No such remote <name>.
• Confusing git remote remove with git remote rm (the latter is an alias but less clear).
• Trying to remove a remote that is still in use by branches or scripts without updating them.

Always check your remote names with git remote -v before removing.

bash

git remote remove wrongname
# Error: error: No such remote 'wrongname'

# Correct way:
git remote remove origin

Output

error: No such remote 'wrongname'

Quick Reference

Command	Description
git remote remove	Remove the remote named from your local repo
git remote -v	List all remotes with their URLs
git remote add	Add a new remote with name and URL

Key Takeaways

Use git remote remove <remote-name> to delete a remote from your local Git repo.

Always verify remote names with git remote -v before removing.

Removing a remote does not delete the remote repository, only the local reference.

If you get an error, check for typos in the remote name.

Keep your branches and scripts updated if they depend on the removed remote.