What is the difference between origin and upstream on GitHub?

by

This should be understood in the context of GitHub forks (where you fork a GitHub repo on GitHub before cloning that fork locally).

  • upstream generally refers to the original repo that you have forked
    (see also “Definition of “downstream” and “upstream”” for more on upstream term)
  • origin is your fork: your own repo on GitHub, clone of the original repo of GitHub

From the GitHub page:

When a repo is cloned, it has a default remote called origin that points to your fork on GitHub, not the original repo it was forked from.
To keep track of the original repo, you need to add another remote named upstream

git remote add upstream https://github.com/<aUser>/<aRepo.git>

(with aUser/aRepo the reference for the original creator and repository, that you have forked)

Note: since Sept. 2021, the unauthenticated git protocol (git://...) on port 9418 is no longer supported on GitHub.

You will use upstream to fetch from the original repo (in order to keep your local copy in sync with the project you want to contribute to).

git fetch upstream

(git fetch alone would fetch from origin by default, which is not what is needed here)

You will use origin to pull and push since you can contribute to your own repository.

git pull
git push

(again, without parameters, ‘origin’ is used by default)

You will contribute back to the upstream repo by making a pull request.

fork and upstream

More Related Contents:

  1. Git branch name – case sensitive or insensitive?
  2. How to pull remote branch from somebody else’s repo
  3. Is there a way to cache https credentials for pushing commits?
  4. Modified files in a git branch are spilling over into another branch
  5. How to get just one file from another branch?
  6. Change a Git remote HEAD to point to something besides master
  7. What does a grey icon in remote GitHub mean
  8. Download single files from GitHub
  9. How is a tag different from a branch in Git? Which should I use, here?
  10. How can I make Jenkins CI with Git trigger on pushes to master?
  11. How much of a git sha is *generally* considered necessary to uniquely identify a change in a given codebase?
  12. git – how to get default branch?
  13. Is there a way to lock a branch in GIT
  14. SSH Key – Still asking for password and passphrase
  15. How can I check out a GitHub pull request with git?
  16. What is a bare repository and why would I need one?
  17. Set Git submodule to shallow clone & sparse checkout?
  18. How can I see the size of a GitHub repository before cloning it?
  19. How do I commit only some files?
  20. A way to restrict Git branch access?
  21. Can I arrange repositories into folders on Github?
  22. Update Git branches from master
  23. fatal: The current branch master has no upstream branch
  24. Create new pull request from fork without having commits of the previous fork
  25. How to delete the last n commits on Github and locally?
  26. How to merge the remote branch and ignore the config setting?
  27. Pushing a large github repo fails with “unable to push to unqualified destination: master”
  28. Git cannot lock ref ‘HEAD’: unable to resolve reference HEAD
  29. Git clone repository error: RPC failed; result=56, HTTP code = 200
  30. npm install package from github repo subfolder

Leave a Comment