I had an interesting problem at work the other day. We'd hired some external contractors to build an android app for us, and now we needed to get the code from them and into our private GitHub. The problem was, I couldn't quickly get them access to the repo since there's a fair amount of process involved in getting those approvals. They also didn't have enough seats to add me as a contributor to their GitHub account, and so we were stuck with me asking them to send a .zip file with the code. Instead, they came back to me with a git bundle file, which I'd never heard of (though I've been using git for a long time now). A git bundle file is essentially a full repository in a single file. You can have branches, history, tags, basically everything you expect in a repository, but it's all contained in a single file. This makes sharing the repository or moving the full repository pretty straightforward. Assume I have a git project called myproj, and I want to send that to someone else.
host1$ cd myproj
host1$ git bundle create repo.bundle master
That will make a bundle file (repo.bundle) that contains all the history of the master branch. You can then send this file to a friend, and they can clone it just like if it were a remote git origin:
host2$ git clone -b master ./repo.bundle myproj
host2$ cd myproj
host2$ git status
On branch master
Your branch is up to date with 'origin/master'.
nothing to commit, working tree clean
Another pretty neat thing about git bundles is, if you need to update one, you can send an incremental file update with only the latest changes. The recipient just puts that in place of their existing bundle, and runs git pull w/in their repo.
This isn't something you'd use every day, but in certain situations (like getting a git repo from one place to another w/out being able to share a remote origin) it works great!
More info on git bundle: https://git-scm.com/docs/git-bundle
Latest comments (19)
One of the best ways to describe bundles. Thank you @gabeguz !
This has saved me today...Thank You
Thank you for sharing!
This is one of those things I'd loved to use in the past 😁
Oh man! This is probably the best way to migrate a repo between providers that do not have integration and especially self-hosted ones.
Usually you’d have to clone and chickout all branches then push them to a new remote. Bit this is much easier! Thank you for sharing!
Mind, blown.
Woh never heard of this. Thanks for sharing it.
Thank you for that info!
Very useful! Thanks Gabriel
Very useful! Thank you!
I actually needed something like this on an offline server not long ago!
Never heard of that, but it sounds like it could be useful in a pinch. Perhaps it also has some (very basic) backup applications, if you want to easily create a backup of a single branch. Thanks for sharing!