Posted in:

There are various guides on the internet to converting a Mercurial repository into a git one, but I found that they tended to assume you had certain things installed that might not be there on a Windows PC. So here’s how I did it, with TortoiseHg installed for Mercurial, and using the version of git that comes with GitHub for Windows. (both hg and git need to be in your path to run the commands shown here).

Step 1 – Clone hg-git

hg-git is a Mercurial extension. This seems to be the official repository. Clone it locally:

hg clone

Step 2 - Add hg-git as an extension

You now need to add hg-git as a mercurial extension. This can either be done by editing the mercurial.ini file that TortoiseHg puts in your user folder, or just enable it for this one repository, by editing (or creating) the hgrc file in the .hg folder and adding the following configuration

hggit = c:/users/mark/code/temp/hg-git/hggit

Step 3 – Create a bare git repo to convert into

You now need a git repository to convert into. If you already have one created on GitHub or BitBucket, then this step is unnecessary. But if you want to push to a local git repository, then it needs to be a “bare” repo, or you’ll get this error: abort: git remote error: refs/heads/master failed to update. Here’s how you make a bare git repository:

git init --bare git_repo

Step 4 – Push to Git from Mercurial

Navigate to the mercurial repository you wish to convert. The hg-git documentation says you need to run the following one-time configuration:

hg bookmarks hg

And having done that, you can now push to your git repository, with the following simple command:

hg push path\to\git_repo

You should see that all your commits have been pushed to git, and you can navigate into the bare repository folder and do a git log to make sure it worked.

Step 5 – Get a non-bare git repository

If you followed step 3 and converted into a bare repository, you might want to convert to a regular git repository. Do that by cloning it again:

git clone git_bare_repo git_regular_repo


Comment by Enrico Siboni

This is the first result for "mercurial to git migation" query... but it doesn't work as is...
I find this thing frustrating for developers needing a fast way to do what they want...
I found the way to do that and now i'm sharing my findings...
Replace Step 4 first commad hg bookmarks hg with hg bookmark -r default master
This solved for me the annoying "conversion fail" problem

Enrico Siboni
Comment by Mark Heath

Thanks for sharing your solution. This post is 7 years old now, so not surprising it doesn't work anymore

Mark Heath
Comment by Remco

It does, really, just did it.

Comment by Remco

Thanks for the reference. This worked like a charm, for me at least.
Did have some issues, but updating mercurial solved most of those.
Also, knowing that master isn't the latest branch since it's renamed to hg does help.
Glad I could finally convert without too much of an issue. Although i prefer hg over git when it's about comprehendability, git has become the default standard. Thanks again for this old, but useful post.