How do I push a new local branch to a remote Git repository and track it too?

Question

How do I:

Create a local branch from another branch (via git branch or git checkout -b).
Push the local branch to the remote repository (i.e. publish), but make it trackable so that git pull and git push will work.

lots of answers containing unrelated information (like how to create a branch) and if the answer applies, then information is missing regarding the magic parameters used. — user12411795, Aug 20, 2020 at 21:05
my workflow is: git checkout -b branch, git push => it prints an error message containing the command you need to run. then copy/paste that command. :) — Kip, Feb 21, 2022 at 13:48

Nate Anderson · Accepted Answer · 2017-09-23 20:27:17Z

8353

In Git 1.7.0 and later, you can checkout a new branch:

git checkout -b <branch>

Edit files, add and commit. Then push with the -u (short for --set-upstream) option:

git push -u origin <branch>

Git will set up the tracking information during the push.

edited Sep 23, 2017 at 20:27

Nate Anderson

19.4k2020 gold badges103103 silver badges140140 bronze badges

answered Jun 3, 2011 at 20:50

Daniel Ruoso

83.8k11 gold badge1818 silver badges88 bronze badges

140

It's also worth noting that if you have an existing tracking branch already set on the branch you're pushing, and push.default is set to upstream, this will not do what you think it will do. It will try to push over the existing tracking branch. Use: git push -u origin mynewfeature:mynewfeature or do git branch --unset-upstream first.
– void.pointer
May 19, 2014 at 18:07
5

I still needed to 'git branch --set-upstream-to origin/remote' in order for 'git status' to correctly report my branch status with respect to the remote branch.
– Paul Whipp
Jul 4, 2014 at 1:17
22

For people using Git from Visual Studio: Actually this is that "Publish Branch" in Visual Studio does. After executing git push with -u parameter i can finally see my branch as published in VS UI.
– Puterdo Borato
Mar 19, 2015 at 11:19
30

You can also use git push -u origin HEAD
– amaslenn
Dec 19, 2017 at 13:30
39

@Stephane You only need the -u once to initiate tracking. Afterward just use git push
– Todd
Jan 11, 2018 at 14:49

Show 6 more comments

ErichBSchulz · Answer 2 · 2018-03-19 01:53:50Z

576

If you are not sharing your repo with others, this is useful to push all your branches to the remote, and --set-upstream tracking correctly for you:

git push --all -u

(Not exactly what the OP was asking for, but this one-liner is pretty popular)

If you are sharing your repo with others this isn't really good form as you will clog up the repo with all your dodgy experimental branches.

edited Mar 19, 2018 at 1:53

answered Jan 20, 2014 at 11:36

ErichBSchulz

15.3k55 gold badges5858 silver badges6161 bronze badges

17

and git pull --all pulls it all back elsewhere ? kewl
– commonpike
Oct 19, 2014 at 21:15
66

Git allows to commit a branch and not push it for very good reasons. Only using git push --all is like dropping a piece of git architecture. If it works for you, it is perfectly ok, great, do it forever. But PLEASE don't recommend others to avoid learning git just because it is a quick way to do things.
– Federico Razzoli
Jul 20, 2016 at 8:24
12

This really isn't the right answer and isn't a good tool to be recommending without a real explanation of what it does and what the implications are. Please consider taking this answer down.
– akronymn
Jan 31, 2017 at 14:30
5

@Federico @akronymn Where can one find the dangers of doing git push --all -u?
– user1823664
Aug 2, 2017 at 16:46
7

@akronymn @ Federico - I've edited it to spell out what I see the dangers are - is that better?
– ErichBSchulz
Mar 19, 2018 at 3:40

Add a comment

flyingdutchman · Answer 3 · 2021-03-02 07:13:45Z

Prior to the introduction of git push -u, there was no git push option to obtain what you desire. You had to add new configuration statements.

If you create a new branch using:

$ git checkout -b branchB
$ git push origin branchB:branchB

You can use the git config command to avoid editing directly the .git/config file:

$ git config branch.branchB.remote origin
$ git config branch.branchB.merge refs/heads/branchB

Or you can edit manually the .git/config file to add tracking information to this branch:

[branch "branchB"]
    remote = origin
    merge = refs/heads/branchB

sometimes your need this git push origin -u local_branch:remote_branch — Bruce Lee, Aug 21, 2018 at 6:28
why does "git push origin -u remote_branch_name " work sometimes and sometimes not? — mss, Jul 26, 2020 at 23:32

Peter Mortensen · Answer 4 · 2016-02-10 19:30:42Z

185

Simply put, to create a new local branch, do:

git branch <branch-name>

To push it to the remote repository, do:

git push -u origin <branch-name>

edited Feb 10, 2016 at 19:30

Peter Mortensen

30.8k2222 gold badges107107 silver badges131131 bronze badges

answered Apr 24, 2015 at 12:09

piyushmandovra

4,23933 gold badges1919 silver badges3030 bronze badges

25

git branch <branch-name> and git checkout -b <branch-name> both create a branch but checkout switch to the new branch
– Robert
Aug 11, 2016 at 14:37
6

dude bracket is just to mention you have to replace with whatever branch name you want to create and push.
– piyushmandovra
May 30, 2018 at 3:41

Add a comment

Alexander Tobias Bockstaller · Answer 5 · 2020-01-29 09:30:47Z

A slight variation of the solutions already given here:

Create a local branch based on some other (remote or local) branch:
```
git checkout -b branchname
```
Push the local branch to the remote repository (publish), but make it trackable so git pull and git push will work immediately
```
git push -u origin HEAD
```
Using HEAD is a "handy way to push the current branch to the same name on the remote". Source: https://git-scm.com/docs/git-push In Git terms, HEAD (in uppercase) is a reference to the top of the current branch (tree).

The -u option is just short for --set-upstream. This will add an upstream tracking reference for the current branch. you can verify this by looking in your .git/config file:

Thank you :) git push -u origin <branch-name> wasn't working for me but using HEAD instead of <branch-name> worked perfectly :) — Daniel Tonon, Nov 7, 2016 at 7:55

Arda · Answer 6 · 2020-09-27 13:43:56Z

I simply do

git push -u origin localBranch:remoteBranchToBeCreated

over an already cloned project.

Git creates a new branch named remoteBranchToBeCreated under my commits I did in localBranch.

Edit: this changes your current local branch's (possibly named localBranch) upstream to origin/remoteBranchToBeCreated. To fix that, simply type:

git branch --set-upstream-to=origin/localBranch

or

git branch -u origin/localBranch

So your current local branch now tracks origin/localBranch back.

git throws error: src refspec <new branch> does not match any. when I try this. — codeforester, Jul 6, 2019 at 0:24
@codeforester exactly the same error I'm facing now, I don't understand how to connect the local_branch to remote_branch in github, can someone help on this — Suresh, Apr 19, 2022 at 7:37
The top one here is the only one that will work if the remote new branch doesn't exist. All other things in here fails for me. New remote branch definition must connect local:remote. — andiOak, Dec 31, 2022 at 2:56

Ashwani Panwar · Answer 7 · 2023-02-01 05:04:04Z

60

git push --set-upstream origin <your branch name>

OR

git push -u origin <your branch name>

edited Feb 1, 2023 at 5:04

answered Apr 28, 2022 at 15:15

Ashwani Panwar

4,06833 gold badges4646 silver badges6868 bronze badges

2

It's worth noting that you can save a bit of typing by using -u as an alternative to --set-upstream. reference
– Paul Rooney
Jan 31, 2023 at 2:13

Add a comment

Devin Rhode · Answer 8 · 2021-01-16 02:49:06Z

edit Outdated, just use git push -u origin $BRANCHNAME

Use git publish-branch from William's miscellaneous Git tools.

OK, no Ruby, so - ignoring the safeguards! - take the last three lines of the script and create a bash script, git-publish-branch:

#!/bin/bash
REMOTE=$1 # Rewrite this to make it optional...
BRANCH=$2
# Uncomment the following line to create BRANCH locally first
#git checkout -b ${BRANCH}
git push ${ORIGIN} ${BRANCH}:refs/heads/${BRANCH} &&
git config branch.${BRANCH}.remote ${REMOTE} &&
git config branch.${BRANCH}.merge refs/heads/${BRANCH}

Then run git-publish-branch REMOTENAME BRANCHNAME, where REMOTENAME is usually origin (you may modify the script to take origin as default, etc...)

this assumes I have ruby installed. no such luck. any other ideas? — Roni Yaniv, May 4, 2010 at 13:20
the ruby script calls git push and git config command. I used the code of the script to edit my answer. You might used this information to create a small shell script that does the puslishing for you. — Lohrun, May 4, 2010 at 13:31
William's miscellaneous git tools appears to have moved (that link is now dead). A working link is: gitorious.org/willgit — Mike D, Oct 27, 2014 at 2:08
"William's" link broken again; new link seems to be git-wt-commit.rubyforge.org — ScottJ, Aug 11, 2016 at 1:07
Edited answer to just have the one working link (github.com/DanielVartanov/willgit) — Devin Rhode, Jan 16, 2021 at 2:49

Hitesh Sahu · Answer 9 · 2021-09-06 10:58:31Z

Complete Git work flow for pushing local changes to anew feature branch looks like this

Pull all remote branches

git pull --all

List all branches now

git branch -a

Checkout or create branch(replace <feature branch> with your branch name):

git checkout -b <feature branch>

shows current branch. Must show with * In front of it

git branch

Add your local changes (. is on purpose here)

git add .

Now commit your changes:

git commit -m "Refactored/ Added Feature XYZ"

Important: Take update from master:

git pull origin feature-branch

Now push your local changes:

git push origin feature-branch

Don't forget the pull request: git-scm.com/docs/git-request-pull — Adam Erickson, Apr 5, 2023 at 17:58

Peter Mortensen · Answer 10 · 2016-02-10 19:26:59Z

I suppose that you have already cloned a project like:

git clone http://github.com/myproject.git

Then in your local copy, create a new branch and check it out:
```
git checkout -b <newbranch>
```
Supposing that you made a "git bare --init" on your server and created the myapp.git, you should:
```
git remote add origin ssh://example.com/var/git/myapp.git
git push origin master
```

After that, users should be able to

git clone http://example.com/var/git/myapp.git

NOTE: I'm assuming that you have your server up and running. If it isn't, it won't work. A good how-to is here.

ADDED

Add a remote branch:

git push origin master:new_feature_name

Check if everything is good (fetch origin and list remote branches):

git fetch origin
git branch -r

Create a local branch and track the remote branch:

git checkout -tb new_feature_name origin/new_feature_name

Update everything:

git pull

William's script I linked to does about the same with the additional option to delete remote branches and some safeguards, too — Tobias Kienzler, May 4, 2010 at 13:07
>to push the local branch to remote repo (publish), but make it >trackable so git pull and git push will work immediately. its what github does automatically when you push your code to their repository :-) — VP., May 4, 2010 at 13:14
This does not respond to the question, the <newbranch> of the original repo is not trackable (and is renamed as <master> is the new repo you clone in step 3). — Lohrun, May 4, 2010 at 13:16
seems kind of overkill. does the git remote add origin make the local branch trackable? is that the key command here? — Roni Yaniv, May 4, 2010 at 13:21
@Roni Yaniv: no git remote add origin only register a new remote repository. It is just a step needed before pushing your branch to that remote repository (if you don't want to type the whole address each time) — Lohrun, May 4, 2010 at 13:25

Shubham · Answer 11 · 2019-01-04 14:43:30Z

To create a new branch by branching off from an existing branch

git checkout -b <new_branch>

and then push this new branch to repository using

git push -u origin <new_branch>

This creates and pushes all local commits to a newly created remote branch origin/<new_branch>

Shubham · Answer 12 · 2019-01-04 14:32:14Z

For GitLab version prior to 1.7, use:

git checkout -b name_branch

(name_branch, ex: master)

To push it to the remote repository, do:

git push -u origin name_new_branch

(name_new_branch, example: feature)

Thuy Trinh · Answer 13 · 2016-01-05 10:11:01Z

I made an alias so that whenever I create a new branch, it will push and track the remote branch accordingly. I put following chunk into the .bash_profile file:

# Create a new branch, push to origin and track that remote branch
publishBranch() {
  git checkout -b $1
  git push -u origin $1
}
alias gcb=publishBranch

Usage: just type gcb thuy/do-sth-kool with thuy/do-sth-kool is my new branch name.

Javier C. · Answer 14 · 2019-10-02 10:11:34Z

You can do it in 2 steeps:

1. Use the checkout for create the local branch:

git checkout -b yourBranchName

Work with your Branch as you want.

2. Use the push command to autocreate the branch and send the code to the remote repository:

git push -u origin yourBanchName

There are mutiple ways to do this but I think that this way is really simple.

Brad Parks · Answer 15 · 2019-07-18 11:29:19Z

Building slightly upon the answers here, I've wrapped this process up as a simple Bash script, which could of course be used as a Git alias as well.

The important addition to me is that this prompts me to run unit tests before committing and passes in the current branch name by default.

$ git_push_new_branch.sh

  Have you run your unit tests yet? If so, pass OK or a branch name, and try again

  usage: git_push_new_branch {OK|BRANCH_NAME}

  e.g.

  git_push_new_branch           -> Displays prompt reminding you to run unit tests
  git_push_new_branch OK        -> Pushes the current branch as a new branch to the origin
  git_push_new_branch MYBRANCH  -> Pushes branch MYBRANCH as a new branch to the origin

git_push_new_branch.sh

function show_help()
{
  IT=$(cat <<EOF

  Have you run your unit tests yet? If so, pass OK or a branch name, and try again

  usage: git_push_new_branch {OK|BRANCH_NAME}

  e.g.

  git_push_new_branch.sh           -> Displays prompt reminding you to run unit tests
  git_push_new_branch.sh OK        -> Pushes the current branch as a new branch to the origin
  git_push_new_branch.sh MYBRANCH  -> Pushes branch MYBRANCH as a new branch to the origin

  )
  echo "$IT"
  exit
}

if [ -z "$1" ]
then
  show_help
fi

CURR_BRANCH=$(git rev-parse --abbrev-ref HEAD)
if [ "$1" == "OK" ]
then
  BRANCH=$CURR_BRANCH
else
  BRANCH=${1:-$CURR_BRANCH}
fi

git push -u origin $BRANCH

Devin Rhode · Answer 16 · 2021-01-16 02:54:32Z

I think this is the simplest alias, add to your ~/.gitconfig

[alias]
  publish-branch = !git push -u origin $(git rev-parse --abbrev-ref HEAD)

You just run

git publish-branch

and... it publishes the branch

Eugene Yarmash · Answer 17 · 2020-05-16 12:10:44Z

For greatest flexibility, you could use a custom Git command. For example, create the following Python script somewhere in your $PATH under the name git-publish and make it executable:

#!/usr/bin/env python3

import argparse
import subprocess
import sys


def publish(args):
    return subprocess.run(['git', 'push', '--set-upstream', args.remote, args.branch]).returncode


def parse_args():
    parser = argparse.ArgumentParser(description='Push and set upstream for a branch')
    parser.add_argument('-r', '--remote', default='origin',
                        help="The remote name (default is 'origin')")
    parser.add_argument('-b', '--branch', help='The branch name (default is whatever HEAD is pointing to)',
                        default='HEAD')
    return parser.parse_args()


def main():
    args = parse_args()
    return publish(args)


if __name__ == '__main__':
    sys.exit(main())

Then git publish -h will show you usage information:

usage: git-publish [-h] [-r REMOTE] [-b BRANCH]

Push and set upstream for a branch

optional arguments:
  -h, --help            show this help message and exit
  -r REMOTE, --remote REMOTE
                        The remote name (default is 'origin')
  -b BRANCH, --branch BRANCH
                        The branch name (default is whatever HEAD is pointing to)

botenvouwer · Answer 18 · 2022-12-08 14:49:57Z

It is now possible (git version 2.37.0) to set git config --global push.autoSetupRemote true. Also see: Automatically track remote branch with git

Thanks, this is exactly what i've been looking for!
– joshp
Dec 1, 2023 at 21:19 — joshp, Dec 1, 2023 at 21:19

Duc Nguyen · Answer 19 · 2023-12-28 15:33:51Z

git push -u origin HEAD

In case you want the remote and local branch to have the same name and don't want to enter the branch name manually

How do I push a new local branch to a remote Git repository and track it too?

19 Answers

Complete Git work flow for pushing local changes to anew feature branch looks like this

ADDED

git_push_new_branch.sh

公告