git remote

The "remote" command helps you to manage connections to remote repositories.

It allows you to show which remotes are currently connected, but also to add new connections or remove existing ones.

Important Options

-v

Shows URLs of remote repositories when listing your current remote connections. By default, listing remote repositories only shows you their shortnames (e.g. "origin"). Using the "-v" option, you will also see the remote's URLs in listings.

add <shortname> <url>

Creates a new connection to a remote repository. The "shortname" you provide can later be used instead of the URL when referencing the remote. A typical default shortname is "origin": this is used for the remote which your local repository was cloned from.

remove <name>

Disconnects the remote from the local repository. Note that this will have no effect on the actual remote repository (i.e. the repository itself is not removed / deleted / etc.).

rename <old-name> <new-name>

Renames the remote connection.

Usage Examples

You can request a list of all remote repositories that are currently connected to your local repository:

$ git remote -v
  origin  https://test@github.com/test/example.git (fetch)
  origin  https://test@github.com/test/example.git (push)

Use the "add" parameter if you want to connect a new remote repository, in this example named "production":

$ git remote add production https://test@github.com/test/example.git

Learn More

• Check out the chapter About Remote Repositories in our free online book
• Find the full command description in the Git documentation
• More frequently asked questions about Git & version control