What does '--set-upstream' do?

git push git-push git-remote upstream-branch
Евгений Масленков picture Евгений Масленков · Aug 3, 2013 · Viewed 319.2k times · Source

What does git --set-upstream do?

I tried to understand it by reading the git manual, but I didn't quite get it.

Answer

TheCodeArtist picture TheCodeArtist · Aug 3, 2013 
git branch --set-upstream <remote-branch>

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 type --set-upstream is to use its shorthand flag -u as follows:

git push -u origin local-branch

This sets the upstream association for any future push/pull attempts automatically.
For more details, checkout this detailed explanation about upstream branches and tracking.

To avoid confusion, recent versions of git deprecate this somewhat ambiguous --set-upstream option in favour of a more verbose --set-upstream-to option with identical syntax and behaviour

git branch --set-upstream-to <origin/remote-branch>

Related questions

Git push to live server

We have a website that has all its PHP/HTML/JS/CSS/etc files stored in a Git repository. We currently have 3 types of computers (or use cases) for the repository. Local developer: pull latest changes, make changes, commit to …

Read More
How do I properly force a Git push?

I've set up a remote non-bare "main" repo and cloned it to my computer. I made some local changes, updated my local repository, and pushed the changes back to my remote repo. Things were fine up to that point. Now, …

Read More
How do you push a tag to a remote repository using Git?

I have cloned a remote Git repository to my laptop, then I wanted to add a tag so I ran git tag mytag master When I run git tag on my laptop the tag mytag is shown. I then want …

Read More