170

Is it possible to shallow clone a specific commit in a repository, i.e. with depth 1? Something like

git clone http://myrepo.git 728a4d --depth 1

to get the repository state as it is at the commit with SHA 728a4d...?

The motivation is to avoid having to clone the whole repository, then check out that specific commit, when we're only interested in the state of the repository at that specific commit.

1

5 Answers 5

178

Starting with Git 2.5.0 (which needs to be available at both the client and server side) you can set uploadpack.allowReachableSHA1InWant=true on the server side to enable fetching of specific SHA1s (must be the full SHA1, not an abbreviation):

git init
git remote add origin <url>
git fetch --depth 1 origin <sha1>
git checkout FETCH_HEAD

Note that I did not find a syntax to do this with git clone directly.

7
  • I got an error saying error: pathspec 'FETCH_HEAD' did not match any file(s) known to git
    – tu4n
    Jan 23, 2019 at 4:54
  • 4
    Playing around with this, I found that it only worked on a very modern version of git client. Even git 2.17 didn't work for me. I rebuilt git at 2.24 and that worked.
    – Eyal
    Dec 15, 2019 at 19:52
  • 3
    Worked for me with 2.27.0.windows.1 on github.com/dotnet/aspnetcore @ 62c098bc170f50feca15916e81cb7f321ffc52ff
    – JJS
    Aug 11, 2020 at 13:01
  • 7
    This now does work with GitHub.
    – John
    Oct 21, 2021 at 23:28
  • 6
    N.B. you have to provide the entire sha1 commit, not an abbreviation!
    – Tom Ellis
    Mar 23, 2022 at 18:17
45

NOTE: My example doesn't help to clone to by a commit hash but it will help to clone a tag and have a lightweight repository.

If you have to have only one commit in your "clone" and you are going to use commit hash, short answer is NO.

I use this command construction (tested on v2.13.2.windows.1) for tags:

git clone --depth 1 [email protected]:VENDOR/REPO.git --branch 1.23.0 --single-branch

Full example:

$ git clone --depth 1 [email protected]:Seldaek/monolog.git --branch 1.23.0 --single-branch
Cloning into 'monolog'...
remote: Counting objects: 201, done.
remote: Compressing objects: 100% (188/188), done.
remote: Total 201 (delta 42), reused 32 (delta 5), pack-reused 0
Receiving objects: 100% (201/201), 190.30 KiB | 0 bytes/s, done.
Resolving deltas: 100% (42/42), done.
Note: checking out 'fd8c787753b3a2ad11bc60c063cff1358a32a3b4'.

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.

If you want to create a new branch to retain commits you create, you may
do so (now or later) by using -b with the checkout command again. Example:

  git checkout -b <new-branch-name>

$ cd monolog

.git dir size (267K vs 2.6M by using full clone):

$ du -h --max-depth=0 .git
267K    .git

I'd like to denote, --branch can take a tag/branch.

https://git-scm.com/docs/git-clone#git-clone---branchltnamegt

--branch can also take tags and detaches the HEAD at that commit in the resulting repository.

UPD

In a nutshell, it can take "refs". You may read more here: What does the git error message “Server does not allow request for unadvertised object” mean?

Also, there is no tricks like:

git fetch --depth 1 origin <COMMIT_HASH>

Thanks @BenjiWiebe for pointing me in my mistake.

10
  • 3
    A million upvotes for this. Way too many people claim this is not possible.
    – jooks
    Mar 7, 2018 at 19:17
  • 7
    --branch does not support commits, only branch names... this doesn't solve it at all. As it not true.
    – abourget
    Mar 9, 2018 at 20:52
  • 2
    Kirby I'm trying to do this now, and it does not work for commits, as @abourget says. Perhaps it works for tags and branches, but I'm trying to do it with commit hashes and that doesn't work.
    – BenjiWiebe
    Mar 13, 2018 at 16:14
  • @BenjiWiebe, I got your point guys. Yeah, it seems, GIT cannot determine a specific commit. :-/ I'll dig it deeper.
    – Kirby
    Mar 14, 2018 at 13:15
  • @BenjiWiebe, so, unfortunately there is no way to use commit hash. Just double checked.
    – Kirby
    Mar 14, 2018 at 13:35
8

Try using while in bash:

git clone --depth=1 $url
i=1; while ! git show $sha1; do git fetch --depth=$((i+=1)); done

This is pretty slow because it fetches each commit individually; you could increase the increment (to fetch commits in batches and improve performance over a network) but it's still a brute force approach.

3
  • Why the down votes? ...I actually needed to do this and my solution got it done!
    – Corin
    Nov 26, 2016 at 4:27
  • what if you want a commit made years ago or that doesn't exist anymore? Feb 18, 2017 at 9:40
  • @DaanBakker, if the commit doesn't exist anymore then the only way to determine this is to fetch the entire remote repository and if it's not there and there are no other clones then you are at a dead end unfortunately.
    – Corin
    Feb 20, 2017 at 23:57
5

The immediate answer is: You can't do it using a git clone directly.
Why? A detailed explanation can be found here: Why Isn't There A Git Clone Specific Commit Option?

What else can you do?

How to clone the repository to a specific commit? (full clone)

# Create empty repository to store your content
git clone <url>
git reset <sha-1> --hard

More info:

How to clone a single branch?

git clone <url> --branch <branch_name> --single-branch <folder_name>

How to clone only latest commit from a given branch?

git clone <url> --depth=1 --branch <branch_name> --single-branch <folder_name>

How to shallow clone a specific commit with depth 1?

As @sschuberth commented out: --depth implies --single-branch.

Instead of clone use the fetch command:

# fetch a commit (or branch or tag) of interest
# In this case you will have the full history of this commit
git fetch origin <sha1>
6
  • 12
    This does not answer the question. The questioner wants to know how to checkout a single commit even if there is no ref pointing directly to it. Jul 8, 2015 at 0:23
  • Sorry, missed it, somehow i understood he need the latest commit. Updating the answer. Thank you
    – CodeWizard
    Jul 8, 2015 at 6:56
  • --depth implies --single-branch, so you could drop it in that case.
    – sschuberth
    Mar 30, 2016 at 13:08
  • Does git fetch actually accept an SHA1 for refspec?
    – Phil Frost
    Jul 5, 2016 at 21:51
  • nope. its simply "downloading" the data which match the name of the branch
    – CodeWizard
    Jul 5, 2016 at 23:23
-1

The answer from https://stackoverflow.com/a/43136160/4411491 works, but it creates a detached head. The following slight modification will avoid this, resulting in a regular single-commit checkout:

# Set those variables:
repourl='https://some.test/somerepo.git'
commit=4e1243bd22c66e76c2ba9eddc1f91394e57f9f83

# Paste the remaining commands unmodified into your shell.       
: ${repourl:?}; reponame=${repourl##*/}; reponame=${reponame%.git}
git init -- "${reponame:?}"
cd -- "${reponame:?}"
git remote add origin "${repourl:?}"
git fetch -q --depth=1 origin "${commit:?}"
git reset --hard FETCH_HEAD

Note that it is imperative that $commit is set to a full commit ID. An abbreviation of the commit ID does not work.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

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