Menu
×
   ❮     
HTML CSS JAVASCRIPT SQL PYTHON JAVA PHP C C++ C# AWS W3.CSS HOW TO BOOTSTRAP REACT MYSQL JQUERY EXCEL XML DJANGO NUMPY PANDAS NODEJS DSA TYPESCRIPT ANGULAR ANGULARJS GIT POSTGRESQL MONGODB ASP AI R GO KOTLIN SWIFT SASS VUE GEN AI SCIPY CYBERSECURITY DATA SCIENCE INTRO TO PROGRAMMING INTRO TO HTML & CSS BASH RUST TOOLS

Git Tutorial

Git HOME Git Intro Git Install Git Config Git Get Started Git New Files Git Staging Git Commit Git Remove and Move Git Tagging Git Stash Git History Git Diff Git Blame Git Help Git Branch Git Merge Git Workflow Git Best Practices

Git and GitHub

GitHub Get Started Git What is SSH? GitHub Add SSH GitHub Set Remote GitHub Edit Code Pull from GitHub Push to GitHub GitHub Branch Pull Branch from GitHub Push Branch to GitHub GitHub Flow GitHub Pages Git GUI Clients

Git Contribute

GitHub Fork Git Clone from GitHub GitHub Send Pull Request

Git Undo

Git Revert Git Reset Git Clean Git Amend Git Rebase Git Reflog Git Recovery

Git Advanced

Git .gitignore Git .gitattributes Git Large File Storage (LFS) Git Signing Commits/Tags Git Cherrypick & Patch Git Bisect Git Merge Conflicts Git CI/CD Git Hooks Git Submodules Git Worktree Git Remote Advanced

Git and Bitbucket

Bitbucket Get Started Bitbucket Add SSH Bitbucket Set Remote Bitbucket Edit Code Bitbucket Branch Bitbucket Pages Bitbucket Fork Git Clone from Bitbucket Bitbucket Send Pull Request

Git and GitLab

GitLab Get Started GitLab Add SSH GitLab Set Remote GitLab Edit Code GitLab Branch GitLab Pages GitLab Fork Git Clone from GitLab GitLab Send Pull Request

Git Cert

Git Certificate

Git Reference

Git Glossary

Git Exercises

Git Terminal Git Exercises Git Challenges Git Quiz Git Syllabus Git Study Plan

Git Advanced Remote


Share

What Are Git Remotes?

Remotes are references to remote repositories.

They let you collaborate, fetch, and push code to shared projects on services like GitHub, GitLab, or Bitbucket.


Why Use Multiple Remotes?

You can add more than one remote to your project. This is useful for:

  • Collaborating with different teams (e.g., your fork and the main project)
  • Mirroring repositories
  • Maintaining backups

How to Add a Remote

To add a new remote repository:

Example: Add a Remote

git remote add upstream https://github.com/other/repo.git
Try it Yourself »

How to Remove a Remote

To remove a remote repository:

Example: Remove a Remote

git remote remove upstream
Try it Yourself »

How to Rename a Remote

To change the name of an existing remote (for example, renaming origin to main-origin):

Example: Rename a Remote

git remote rename origin main-origin
Try it Yourself »


How to List All Remotes

See all remotes and their URLs:

Example: List Remotes

git remote -v
origin  https://github.com/w3schools-test/hello-world.git (fetch)
origin  https://github.com/w3schools-test/hello-world.git (push)
upstream        https://github.com/other/repo.git (fetch)
upstream        https://github.com/other/repo.git (push)
Try it Yourself »

How to Show Remote Details

Get detailed information about a specific remote (such as fetch/push URLs and tracked branches):

Example: Show Remote Info

git remote show upstream
Try it Yourself »

How to Fetch from a Remote

Fetch changes from any remote:

Example: Fetch from Upstream

git fetch upstream
Try it Yourself »

How to Push to a Remote

Push your local branch to a specific remote repository:

Example: Push to a Remote

git push upstream main
Try it Yourself »

How to Track a Remote Branch

To set up a local branch to track a branch from a remote:

Example: Track a Remote Branch

git checkout -b new-feature upstream/new-feature
Switched to a new branch 'new-feature'
branch 'new-feature' set up to track 'upstream/new-feature'.
Try it Yourself »

Note: Managing multiple remotes is common in open source projects (e.g., origin for your fork, upstream for the main project).


Troubleshooting and Best Practices

  • If you get "remote not found", check the spelling of the remote name with git remote -v.
  • If fetch or push fails, make sure you have access to the remote repository.
  • Use git remote show <name> to see details and troubleshoot issues.
  • Check your network connection if you cannot reach a remote server.
  • Use clear, descriptive names for remotes (e.g., origin, upstream, backup).
  • Remove unused remotes to keep your project tidy.



Free account

Track your progress

XP earned 0 Day streak 0 Spaces 0 League —

New

Learn in Adventure Mode W3Schools Adventure App

Coding fundamentals as bite-sized lessons and challenges.

×

Contact Sales

If you want to use W3Schools services as an educational institution, team or enterprise, send us an e-mail:
sales@w3schools.com

Report Error

If you want to report an error, or if you want to make a suggestion, send us an e-mail:
help@w3schools.com

W3Schools is optimized for learning and training. Examples might be simplified to improve reading and learning. Tutorials, references, and examples are constantly reviewed to avoid errors, but we cannot warrant full correctness of all content. While using W3Schools, you agree to have read and accepted our terms of use, cookies and privacy policy.

Copyright 1999-2026 by Refsnes Data. All Rights Reserved. W3Schools is Powered by W3.CSS.