My colleague and I are working on the same repository we've branched it into two branches each technically for different projects, but they have similarities so we'll sometimes want to commit back to the *master from the branch.

However, I have the branch. My question is, how can my colleague pull that branch specifically? A git clone of the repo does not seem to create the branches locally for him, though I can see them live on unfuddle after a push on my end.

Also, when I originally made the branch I did -b checkout. Not sure if that makes much difference?

iMac:test_solar dave$ git branch -r
origin/HEAD -> origin/master
origin/daves_branch
origin/discover
origin/master

git fetch origin discover
git checkout discover

These are the commands I ran. But it definitely is not working. I want to be able to check out that branch and then push and commit back just the branches changes from various collaborators or workstations.

24 Answers 24

up vote 2243 down vote accepted

You need to create a local branch that tracks a remote branch. The following command will create a local branch named daves_branch, tracking the remote branch origin/daves_branch. When you push your changes the remote branch will be updated.

For most versions of git:

git checkout --track origin/daves_branch

--track is shorthand for git checkout -b [branch] [remotename]/[branch] where [remotename] is origin in this case and [branch] is twice the same, daves_branch in this case.

For git 1.5.6.5 you needed this:

git checkout --track -b daves_branch origin/daves_branch

For git 1.7.2.3 and higher this is enough (might have started earlier but this is the earliest confirmation I could find quickly):

git checkout daves_branch

Note that with recent git versions, this command will not create a local branch and will put you in a 'detached HEAD' state. If you want a local branch, use the --track option. Full details here: http://git-scm.com/book/en/v2/Git-Branching-Remote-Branches#Tracking-Branches

  • 92
    "git fetch" to make sure your repo is updated with remote references and "git checkout --track origin/discover" should be enough. Then you can commit to that branch and a "git push" to sync the remote with your changes. – ralphtheninja Mar 2 '12 at 17:54
  • 31
    I tried this and got "fatal: git checkout: updating paths is incompatible with switching branches. Did you intend to checkout 'upstream/develop' which can not be resolved as commit?". Am I doing something wrong? – Neil Barnwell Apr 8 '12 at 22:40
  • 41
    Looks like git 1.5.6.5 needs this instead: git checkout --track -b origin/daves_branch – Charlie Jul 12 '13 at 13:31
  • 32
    This made a mess for me, it created a local branch named origin/<branch> which is now ambiguous to the remote branch origin/<branch> and I don't know how to get rid of the crazy local branch! – Alan Moore Jul 9 '15 at 17:00
  • 21
    You need to add the local branch name explicitly, otherwise git creates a new local branch with the full branch path, as @AlanMoore and @derekmx271 stated above: git checkout -b --track daves_branch origin/daves_branch – Mike Scott Jul 22 '15 at 15:57

I have used fetch followed by checkout ...

git fetch <remote> <rbranch>:<lbranch> 
git checkout <lbranch>

... where <rbranch> is the remote branch or source ref and <lbranch> is the as yet non-existent local branch or destination ref you want to track and which you probably want to name the same as the remote branch or source ref. This is explained under options in the explanation of <refspec>.

Git is so smart it auto completes the first command if I tab after the first few letters of the remote branch. IE: I don't even have to name the local branch, Git automatically copies the name of the remote branch for me. Thanks Git!

Also as the answer in this similar SO post shows, if you don't name the local branch in fetch, you can still create it when you check it out by using the -b flag. IE: git fetch <remote> <branch> followed by git checkout -b <branch> <remote>/<branch> does exactly the same as my initial answer. And evidently if your repo has only one remote, then you can just do git checkout <branch> after fetch and it will create a local branch for you. EG: You just cloned a repo and want to check out additional branches from the remote.

I believe that some of the documentation for fetch may have been copied verbatim from pull. In particular the section on <refspec> in options is the same. However, I do not believe that fetch will ever merge, so that if you leave the destination side of the colon empty fetch should do nothing.

NOTE: That git fetch <remote> <refspec> is short for git fetch <remote> <refspec>: which would therefore do nothing, but git fetch <remote> <tag> is the same as git fetch <remote> <tag>:<tag> which should copy the remote <tag> locally.

I guess this is only helpful if you want to copy a remote branch locally, but not necessarily check it out right away. Otherwise I now would use the accepted answer above, which is explained in detail in the first section of the checkout description and later in the options section under the explanation of --track, since it's a 1-liner. Well... sort of a 1-liner, because you would still have to run git fetch <remote> first.

FYI: The order of the <refspecs> (source:destination) explains the bizarre pre Git-1.7 method for deleting remote branches. IE: Push nothing into the destination refspec.

  • 8
    You assume Git autocompletion is setup. code-worrier.com/blog/autocomplete-git – antonagestam Aug 29 '13 at 9:19
  • 1
    This worked for me to get the remote code into a local branch. It did not however get my local branch to track the remote branch. – Aknosis Sep 17 '14 at 22:35
  • 56
    This worked for me, the accepted answer didn't. – Parthian Shot Jun 25 '15 at 17:57
  • 1
    For some reason, git fetch remote branch didn't add a branch head at all for me, though all the refs got fetched, so when I tried to follow the steps in the accepted answer, I got the error that pathspec did not match any file(s) known to git., but the rbranch:lbranch approach worked. Interestingly, it also fetched all the tags that started with the same prefix, like it is a wildcard (rbranch*). – haridsv Jun 30 '15 at 8:36
  • 2
    Nit: git doesn't do the autocompleting, it is the bash shell that is doing it. – legalize Dec 29 '15 at 20:44

If you are trying to "checkout" a new remote branch (that exists only on the remote, but not locally), here's what you'll need:

git fetch origin
git checkout --track origin/<remote_branch_name>

This assumes you want to fetch from origin. If not, replace origin by your remote name.

  • 5
    "pull" from origin is confusing language, better to change your comment above to "fetch" from origin. Pull is a command that does a fetch and a merge and that certainly confuses newcomers (me included) – Davos Jun 18 '14 at 3:38
  • Worked for me! Adding it into my notes now :) Thank u! – hmd Sep 30 '16 at 7:09
  • 1
    Worked for me, I hadn't fetched the correct remote branch so the accepted answer kept failing for me with a confusing message. +1 – Nathan Hinchey May 16 '17 at 16:32
  • Simple and sweet, I'm sure most users just want to do this operation at first place. – vikramvi Jun 7 '17 at 10:21
  • This is what I have always been looking for ! Thank you @paneer_tikka – Kris Randall May 8 at 5:11

To checkout myBranch that exists remotely and not a locally - This worked for me:

git fetch --all
git checkout myBranch

I got this message:

Branch myBranch set up to track remote branch myBranch from origin
Switched to a new branch 'myBranch'
  • 1
    In other words you don't have to write -t? – Andrew Samuelsen Apr 7 '14 at 16:47
  • 2
    I think there's an error in this answer. I originally did the command without -t and got You are in 'detached HEAD' state. You can look around, make experimental changes and commit them, and you can discard any commits you make in this state without impacting any branches by performing another checkout. because there wasn't a local branch of the same name. I had to re-run with -t to fix. – stanri Sep 23 '15 at 16:38
  • 1
    This worked well for me - my colleague had added a new remote branch that I wanted to add to my local repo. I kept fetching but didn't see the new branch appearing locally. Didn't realize that I could just run checkout for it to create it. Thanks! – skwidbreth Jul 22 '16 at 16:23
  • 1
    depends on git versions. Latest version, as said elsewhere here, only needs git checkout <name of branch on origin>. BE CAREFUL WITH SAME-NAME LOCAL vs REMOTE BRANCHES - they will mess stuff up – leRobot Jul 14 '17 at 11:20

Use git branch -a (both local and remote branches) or git branch -r (only remote branches) to see all the remotes and their branches. You can then do a git checkout -t remotes/repo/branch to the remote and create a local branch.

There is also a git ls-remote command to see all the refs and tags for that remote.

  • git checkout remotes/repo/branch makes git checkout look for a pathspec, not a remote repo. – Erin Feb 15 '13 at 19:09
  • 1
    Yes, is it even possible to checkout a branch on the remote repo? Obviously (or maybe it wasn't so obvious), remotes are first fetched so that you have them locally. The git book has a good section on them: git-scm.com/book/en/Git-Branching-Remote-Branches – Daniel Lee Feb 16 '13 at 1:15

The title and the question are confused:

  • Git fetch remote branch
  • how can my colleague pull that branch specifically.

If the question is how can I get a remote branch to work with or how to git checkout a remote branch, a simpler solution is:

With git (>= 1.6.6) you are able to use:

git checkout <branch_name>

If local <branch_name> is not found but there does exist a tracking branch in exactly one remote with a matching name, treat as equivalent to:

git checkout -b <branch_name> --track <remote>/<branch_name>

see documentation for git checkout

For your friend:

$ git checkout discover
Branch discover set up to track remote branch discover
Switched to a new branch 'discover'
git checkout -b serverfix origin/serverfix

This is a common enough operation that git provides the --track shorthand:

git checkout --track origin/serverfix

In fact, this is so common that there’s even a shortcut for that shortcut. If the branch name you’re trying to checkout (a) doesn’t exist and (b) exactly matches a name on only one remote, Git will create a tracking branch for you:

git checkout serverfix

To set up a local branch with a different name than the remote branch, you can easily use the first version with a different local branch name:

git checkout -b sf origin/serverfix

Now, your local branch sf will automatically pull from origin/serverfix.

Source: Pro Git 2nd Edition, written by Scott Chacon and Ben Straub (cut for readability)

  • Works! Thanks you! – Karl Pokus Feb 19 at 14:50
git fetch

git branch -r

git checkout <branch_name>

You can fetch and checkout the remote branch in one shot too:-

git fetch && git checkout the-branch-name

With this simple command:

git checkout -b 'your_branch' origin/'remote branch'
  • great simple answer that works. should be toward the top IMO – russiansummer May 2 at 22:51

I typed

git checkout <branch_name>

and got

Branch <branch_name> set up to track remote branch <branch_name> from origin.
Switched to a new branch '<branch_name>'
  • from git checkout documentation: If <branch_name> is not found but there does exist a tracking branch in exactly one remote with a matching name, treat as equivalent to: git checkout -b <branch_name> --track <remote>/<branch_name> – Guillaume Vincent Mar 31 '14 at 10:49

At times you are asked not to fiddle with the master branch and work only the remote branch (as I was asked to). So all you need is the remote branch.

So to clone the remote branch alone (without the master), do this

git clone url --branch remote_branch_name

where, remote_branch_name is the name of the remote branch

For example,

git clone git://git.kernel.org/pub/scm/linux/kernel/git/stable/linux-stable.git --branch v3.15

This will make sure that you clone the remote branch to your local branch with the name of the remote branch.

Now if you commit your code and push, the code will be submitted to that branch alone.

The easiest way to do it, at least for me:

git fetch origin <branchName>

git fetch --all & git checkout <branch name>

The steps are as follows;

  1. git fetch origin or git fetch --all , this will fetch all the remote branches to your local and then this the second option you can proced with.

  2. git checkout --track origin/<The_remote_branch you want to switch over>

Then work on this branch and you can verify whether you are on that branch or not by typing

git branch

It displayes the branch you currently in.

  • 1
    This worked for me. – CreativeMind Sep 30 '14 at 13:39

If you already know your remote branch like so...

git remote
=> One
=> Two

and you know the branch name you wish to checkout ex. br1.2.3.4 then do

git fetch One
=> returns all meta data of remote i.e. the branch name in question.

all that is left is to checkout the branch

git checkout br.1.2.3.4

Then make any new branches off of it.

Let's say that your remote is git@xyz.git and you want its random_branch branch. The process should be as follows:

  1. First check the list of your remotes by

    git remote -v

  2. If you don't have the git@xyz.git remote in the above command's output, you would add it by

    git remote add xyz git@xyz.git

  3. Now you can fetch the contents of that remote by

    git fetch xyz

  4. Now checkout the branch of that remote by

    git checkout -b my_copy_random_branch xyz/random_branch

  5. Check the branch list by

    git branch -a

The local branch my_copy_random_branch would be tracking the random_branch branch of your remote.

Check your .git/config, particulary what tracking is present on fetch for that remote.

[remote "randomRemote"]
    url = git@github.com:someUser/someRepo.git
    fetch = +refs/heads/*:refs/remotes/randomRemote/*

If it has heads/* pointing to randomRemote/*, when you run git fetch randomRemote, it will fetch all branches. Then you can just checkout that branch.

Otherwise,

  1. You need to add remote branches to the tracking using this. Check your .git/config after running this. You will understand. git remote set-branches --add randomRemote randomBranch

  2. Run git fetch randomRemote. This will fetch the remote branch.

  3. Now you can run git checkout randomBranch

git fetch && git checkout <your friend's branch name> should do the trick

You use 'git pull' to keep your branches separate. I will use actual repo and branch names to help since 'lbranch' and 'rbranch' is tough to decipher.

Let's use:

  • myteam.unfuddle.com = the remote git server
  • tlc = unfuddle project account where the repo exists
  • daves_branch = remote branch name

    You, or any colleague, can run this to pull only your branch, no matter how many branches there are:

    git init
    git pull git@myteam.unfuddle.com:myteam/tlc daves_branch:refs/remotes/origin/daves_branch
    

    simply try

    $git pull origin your_branch_name

    • 1
      Rizo, git pull origin branch_name should be the best solution. You are the only person that posted this as a solution and it worked for me. This works because it will update your branch with the master branch. simple and uncomplicated. – Ian Poston Framer Aug 13 at 16:31
    • thanks, appreciate – Rizo Aug 14 at 18:13

    If you have a repository that was cloned with --depth 1 then many of the commands that were listed will not work. For example see here

    % git clone --depth 1 https://github.com/repo/code
    Cloning into 'code'...
    cd code
    remote: Counting objects: 1778, done.
    remote: Compressing objects: 100% (1105/1105), done.
    remote: Total 1778 (delta 87), reused 1390 (delta 58), pack-reused 0
    Receiving objects: 100% (1778/1778), 5.54 MiB | 4.33 MiB/s, done.
    Resolving deltas: 100% (87/87), done.
    Checking connectivity... done.
    Checking out files: 100% (1215/1215), done.
    % cd code
    % git checkout other_branch
    error: pathspec 'other_branch' did not match any file(s) known to git.
    % git fetch origin other_branch
    remote: Counting objects: 47289, done.
    remote: Compressing objects: 100% (15906/15906), done.
    remote: Total 47289 (delta 30151), reused 46699 (delta 29570), pack-reused 0
    Receiving objects: 100% (47289/47289), 31.03 MiB | 5.70 MiB/s, done.
    Resolving deltas: 100% (30151/30151), completed with 362 local objects.
    From https://github.com/repo/code
     * branch            other_branch-> FETCH_HEAD
    % git checkout other_branch
    error: pathspec 'other_branch' did not match any file(s) known to git.
    %
    

    In this case I would reclone the repo, but perhaps there are other techniques e.g. git shallow clone (clone --depth) misses remote branches

    A simple command -"git checkout remote_branch_name" will help you to create a local branch that has all the changes in remote branch.

    git branch <name> --track origin/<name>

    protected by Tushar Gupta Jun 24 '15 at 5:33

    Thank you for your interest in this question. Because it has attracted low-quality or spam answers that had to be removed, posting an answer now requires 10 reputation on this site (the association bonus does not count).

    Would you like to answer one of these unanswered questions instead?

    Not the answer you're looking for? Browse other questions tagged or ask your own question.