about summary refs log tree commit diff stats
path: root/content/post/git-cloning-similar-repositories.md
blob: 3200646fc0ab72cb999ac0af9e24e9fa620069f6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
+++
description = "Speed up cloning of similar git repositories"
title = "Cloning Similar Git Repositories"
date = 2014-06-22T08:35:24Z
[taxonomies]
categories = ["Development"]
tags = ["git"]
+++
With multiple similar git repositories, for example where a base repository contains a framework or base system installation and other repositories are created from that repository, it's possible to save some time when cloning down another repository by using the `reference` option to [git-clone][]:

	git clone git@github.com/my/repo --reference another-repo
(Where `another-repo` points to a local version of a repository.)

The reference here doesn't have to be the base repository itself, it could just be another variant of it.  The speedup can be quite dramatic if the repositories have megabytes of shared history, from minutes to seconds.

On a related note, I'm surprised that [GitHub][] doesn't allow for multiple renamed forks, which would be very useful in this scenario.  [BitBucket][] does support this, however.  It even has a 'sync' button for pulling updates from the base into the child repositories, which is very useful, especially for those who prefer GUIs over CLIs.

[git-clone]:https://www.kernel.org/pub/software/scm/git/docs/git-clone.html
[GitHub]:https://github.com
[BitBucket]:https://bitbucket.org/