[set upstream] What does '--set-upstream' do? #tags: git

upstream.md

git branch --set-upstream-to <remote-branch>
# example
git branch --set-upstream-to origin feature-branch

# show up which remote branch a local branch is tracking
git branch -vv

sets the default remote branch for the current local branch.

Any future git pull command (with the current local branch checked-out), will attempt to bring in commits from the <remote-branch> into the current local branch.

One way to avoid having to explicitly do --set-upstream is to use the shorthand flag -u along with the very first git push as follows

git push -u origin local-branch

---

• Origin post: https://stackoverflow.com/a/18032014/3697757
• Gist managed by Lepton

Thanks! The very last line can be misleading:

git push -u origin local-branch

Did you actually mean:

git push -u origin remote-branch

:)

This is gold!
This could potentially help more people if you consider updating this into the git push documentation. Currently, the following is not as easy-to-understand as yours:

For every branch that is up to date or successfully pushed, add upstream (tracking) reference, used by argument-less git-pull[1] and other commands. For more information, see branch..merge in git-config[1].

Thanks! The very last line can be misleading:

git push -u origin local-branch

Did you actually mean:

git push -u origin remote-branch

:)

No. local-branch because you are currently on a remote branch

very helpful thank you! 👍

🔥

Your explanation is very clear and helpful, Thanks

Best solution for this situation, because it does not require you to git push.

You made our life easier. First time creating branch in a prod project. Thanks man!

thank u for good info.

Thank you!

Thank you it was helpful