Converting Mercurial Repositories to Git on Windows
If you work with text, you need version control. That rule applies regardless of whether you write code or poetry (some might argue that those two are the same, anyway). Ignoring the CVS and SVN dinosaurs two distributed version control systems are being regarded as state of the art: Git and Mercurial. Functionality-wise they are nearly identical, but it seems that Git, with its open-source background, is poised to take over the enterprise, too, where Mercurial used to be strongest.
If you are just getting started with version control, take a look at the excellent SourceTree client software, and consider one of the popular hosting services Bitbucket, Github or Visual Studio Online, each of which have very usable free plans (although it should be mentioned that Github offers private repositories only for paid accounts).
If have have been using version control for some time you might have a number of Mercurial repositories that you want to convert to Git. The remainder of this article explains how to do that on Windows.
This guide assumes you have TortoiseHg and Git installed. When installing Git make sure to select the option Use Git from the Windows Command Prompt as shown in the following screenshot. No other software is required.
Edit your mercurial configuration file (located in
%Userprofile%\mercurial.ini), adding the following lines:
[extensions] hggit = hgext.bookmarks = [git] intree = True
This enables the hg-git extension and instructs it to create
.git repository directories next to
.hg repository directories instead of putting them in subdirectories named
On the command line, make sure hg-git is enabled correctly by running:
hg help hggit
It should print something like this:
hggit extension - push and pull from a Git server This extension lets you communicate (push and pull) with a Git server. This way you can use Git hosting for your project or collaborate with a project that is in Git. A bridger of worlds, this plugin be. Try hg clone git:// or hg clone git+ssh:// For more information and instructions, see "hg help git" list of commands: gclear clear out the Git cached data gexport export commits from Mercurial to Git gimport import commits from Git to Mercurial git-cleanup clean up Git commit map after history editing gverify verify that a Mercurial rev matches the corresponding Git rev (use "hg help -v hggit" to show built-in aliases and global options)
Converting a Mercurial Repository to Git
On the command line, navigate to the mercurial repository you want to convert. This is the directory that contains the
Run the following command to make a bookmark of master for default, so a reference gets created:
hg bookmark -r default master
Run the following command to create the
.git repository directory:
hg gexport --debug
If you made a mistake or forgot something and want to start over simply delete the
.git subdirectory and run:
Git: Turning a Bare into a Working Repository
You now have a bare Git repository in addition to the existing Mercurial repository. Turn the bare into a working repository by running:
git config --bool core.bare false
Create the index (otherwise, Git believes everything has been deleted, since a bare
.git repository doesn’t include a file
git reset HEAD -- .
Your local source directory now contains both a Mercurial and a Git repository:
That is not exactly what they tell you in coding school, but – it works!
You can push the new local Git repository to a remote hosting service like Bitbucket or Visual Studio Online comfortably with Atlassian’s SourceTree client.
You might also want to convert existing
.hgignore files to
.gitignore files. Unfortunately they are not fully compatible, as
.gitignore does not support regular expressions.
Thanks! This was very helpful!
I need a little clarification. Where I work, we have a default project with multiple branches. Do I do this conversion for the default and then for each branch? Each one of these has their own folder structure complete with an .hg folder. Some guys here think one conversion is enough to pull in all branches.
Yes clarification need on this. Please let us know whether only the master will be converted or all the branches and tags?
How do I get rid of the former .hg repository when finished?
Do I just delete the .hg folder?
Yes, you can simply delete the .hg directory once you do not need it any more.
Sorry, I know this is an old post, but when I issue the commend git reset HEAD — ., I get this error:
fatal: Could not parse object ‘HEAD`.
Any advice on how I might solve this? Thx.
Ahh, solved my own problem. I needed to use hg gclear because this was my second time trying this process for this particular repo. I had thought I just needed to delete the .git folder, but this didn’t reset things on the hg side.
I”m wanting to import the hg repository as a sub directory in an existing git repository, can you give any guidance on this?
Thanks, Superb post everything fine but I need to retrieve all the tags from old repository to git how can I??
Thanks a lot, this article help me lot…. good one
This has worked for me locally but when it try to do push i get an error, i hose my code on BitComet, seems like on bitbucket it’s still mercurial repo but locally it’s git so when i try to do push it conflicts. Is there anything i need to do to convert it to git on remote ?
Working bad if you have not latin symbols in filenames. It creates not printable symbols instead it. It can be pushed after this but after that you will have a lot problems with remove them from repo.
I’m getting this error on the “hg gexport –debug” command:
abort: data/[….] /[email protected]: no match found!
Any idea what’s wrong?