4035

Git clone will clone remote branch into local.

Is there any way to clone a specific branch by myself without switching branches on the remote repository?

0

7 Answers 7

8929
git clone -b <branch> <remote_repo>

Example:

git clone -b my-branch [email protected]:user/myproject.git

With Git 1.7.10 and later, add --single-branch to prevent fetching of all branches. Example, with OpenCV 2.4 branch:

git clone -b opencv-2.4 --single-branch https://github.com/Itseez/opencv.git
14
  • 582
    pierr: I'm not sure if this answers the description of the problem given above, but it does answer the actual question - how to clone a specific branch of a repository. I voted this up because it's the answer I was googling for when I came to this page. May 15, 2011 at 3:35
  • 29
    This works. It points the new HEAD at the specified branch rather than at the HEAD-branch in myproject. However, it still fetches all branches. See @edmar-miyake's answer.
    – cdunn2001
    Mar 17, 2012 at 20:35
  • 4
    It answers the description of the problem if you add a --depth X to the command. If you do so, it will clone only the specified branch and its last content.
    – ramsvidor
    Sep 12, 2013 at 23:32
  • 9
    thx for --single-branch; git 2.5 is out at time of writing this. Don't care for older versions. Aug 20, 2015 at 10:46
  • 4
    @jorge Why -b option requires a separate --single-branch flag? Does -b alone clones all branches?
    – CᴴᴀZ
    Jul 11, 2018 at 6:23
2479
git clone --single-branch --branch <branchname> <remote-repo>

The --single-branch option is valid from version 1.7.10 and later.

Please see also the other answer which many people prefer.

You may also want to make sure you understand the difference. And the difference is: by invoking git clone --branch <branchname> url you're fetching all the branches and checking out one. That may, for instance, mean that your repository has a 5kB documentation or wiki branch and 5GB data branch. And whenever you want to edit your frontpage, you may end up cloning 5GB of data.

Again, that is not to say git clone --branch is not the way to accomplish that, it's just that it's not always what you want to accomplish, when you're asking about cloning a specific branch.

6
  • Comments are not for extended discussion; this conversation has been moved to chat. Apr 2, 2019 at 19:37
  • 2
    Pardon me, are you sure about the part you said "you're fetching all..."? I read somewhere that git fetch doesn't actually "copy" any files, it just fetches metadata and information about the changes. So it should be relatively light weight... Maybe you've used the word "fetch" literally and not from the git vocabulary?
    – aderchox
    Jul 16, 2020 at 8:29
  • 3
    @aderchox, no it will actually fetch all the content. It is pretty smart about things it transfers when you update, but when you clone a big repository it actually pulls the history, unless you explicitly tell it not to. But it will still fetch the tip of the branch. What git fetch does not — it does not check out files, but that's not about the transfer. Jul 16, 2020 at 13:07
  • 8
    Often you will also want --depth 1 so that you only get the latest. This can save a lot of downloading time.
    – Eyal
    Feb 4, 2021 at 3:57
  • git clone -b branch_name --single-branch 'repo_url' Mar 29, 2022 at 15:37
357

Here is a really simple way to do it :)

Clone the repository

git clone <repository_url>

List all branches

git branch -a 

Checkout the branch that you want

git checkout <name_of_branch>
10
  • 1
    This switched the working directory to the correct branch, but I'm not able to push any changes I make, because I'm not "currently on a branch". Jan 21, 2015 at 9:46
  • 6
    This was the solution for me, since I had already cloned 'master'. I didn't know I could simply 'checkout' a remote branch.
    – yazzer
    Jul 30, 2015 at 21:34
  • 2
    This is probably the correct way to do it; best-practices-wise
    – aaiezza
    Jul 25, 2016 at 21:01
  • 1
    This way doesn't clone only the choosen branch. This answer seems better: stackoverflow.com/a/7349740/3075243. For example if a repo has many branches that are big enough that we don't wanna clone each one.
    – Proustibat
    Jan 31, 2018 at 23:04
  • 5
    Very crisp answer. One additional things you have to do is: After this step: "git checkout <name_of_branch>" Do this: git branch --set-upstream-to=origin/<branch> <local_branch> Thanks. Apr 11, 2018 at 23:42
267

To clone a branch without fetching other branches:

mkdir $BRANCH
cd $BRANCH
git init
git remote add -t $BRANCH -f origin $REMOTE_REPO
git checkout $BRANCH
5
  • 1
    Good solution. On older git (I have 1.5.5.6), a git branch --track $BRANCH origin/$BRANCH may be needed before the checkout. Aug 13, 2013 at 13:19
  • 2
    Works, and also fetches just those tags present on the branch, which is what I wanted. (I actually wanted to fetch multiple branches, but only selected ones; for that, it sufficed to repeatedly remote add and checkout as here, then git remote rm origin to clean up.) Sep 3, 2014 at 1:45
  • 2
    Perfect solution for shallowly incorporating a specific tag of a git repo in another project. Recommend omitting -f from the git remote command, then using git fetch --depth=1 $BRANCH $TAG, then git checkout FETCH_HEAD. The init is innocuous, and changing tags will automatically update the checked out code.
    – taranaki
    May 12, 2017 at 20:41
  • Unlike Michael Krelin's (3-step) answer, this one actually worked for me (git 1.7.9.5)
    – Bobby Jack
    Dec 14, 2018 at 13:11
  • after alot of fail, this code is works to me.. git version 2.9.2
    – Budi Mulyo
    Jan 24, 2019 at 8:17
144

Use:

git checkout -b <branch-name> <origin/branch_name>

For example in my case:

 git branch -a
* master
  origin/HEAD
  origin/enum-account-number
  origin/master
  origin/rel_table_play
  origin/sugarfield_customer_number_show_c

So to create a new branch based on my enum-account-number branch, I do:

git checkout -b enum-account-number origin/enum-account-number

After you hit Return, the following happens:

Branch enum-account-number set up to track remote branch refs/remotes/origin/enum-account-number.
Switched to a new branch "enum-account-number"
3
  • 4
    Note that it may be useful to git pull origin first so that git branch -a can list all new (current) remote branches. Oct 12, 2012 at 4:13
  • 1
    Good point. Probably git fetch is better so that the auto merge doesn't happen, though.
    – dkinzer
    Oct 12, 2012 at 14:09
  • this solution is helpful for creating a new local branch, switching to it and setting up to track the corresponding remote branch
    – Nissal
    Feb 20, 2023 at 16:46
40

Create a branch on the local system with that name. e.g. say you want to get the branch named branch-05142011

git branch branch-05142011 origin/branch-05142011

It'll give you a message:

$ git checkout --track origin/branch-05142011
Branch branch-05142011 set up to track remote branch refs/remotes/origin/branch-05142011.
Switched to a new branch "branch-05142011"

Now just checkout the branch like below and you have the code

git checkout branch-05142011
6
  • 7
    This will do too : git fetch origin [remote-branch]:[new-local-branch] May 15, 2011 at 21:09
  • has it right. Miyake (below) shows how to do it when the remote is added.
    – cdunn2001
    Feb 23, 2012 at 21:37
  • That should say, "PlanetUnknown has it right."
    – cdunn2001
    Feb 26, 2012 at 21:38
  • 3
    @PlanetUnknown Thanks for git fetch origin [remote-branch]:[new-local-branch], I love that! Mar 9, 2012 at 5:49
  • 1
    I tried git branch ue5-early-access origin/ue5-early-access and it errors: "fatal: Not a valid object name: 'origin/ue5-early-access'.", any tip? Aug 19, 2021 at 1:21
35
git --branch <branchname> <url>

But Bash completion don't get this key: --branch

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