Source archives and binary packages for various systems. See WhatsNew for information on upgrading.

1. Binary packages

1.1. Windows

/!\ Like TortoiseSVN, we recommend turning off the indexing service on the working copies and repositories, and excluding them from virus scans.

1.2. Mac OS X

1.3. Linux (.deb)

Mercurial (from 1.0 onwards) is packaged for Debian-related distributions as two packages, mercurial and mercurial-common - you only need to care about this if you are downloading .deb files for manual installation - otherwise, APT dependency handling will take care of this for you when you install mercurial.

Another way to get .deb packages is to build them from a Mercurial source repository with make deb (builds on local system) or make docker-<distro>-<codename> (e.g. docker-debian-stretch or docker-ubuntu-bionic, see contrib/packaging/Makefile).

To get the latest Mercurial version, instead of the old versions listed above, try:

sudo add-apt-repository -y ppa:mercurial-ppa/releases
sudo apt-get update
sudo apt-get install -y python-pip python-dev
sudo pip install mercurial --upgrade

(see the full answer on stackoverflow)

1.4. Linux (.rpm)

Since Mercurial version 3.4, the Mercurial project provides packages for the following systems:

You can download, install and upgrade the packages manually.

You can also add it as a "yum" package repository and get automatic updates: Add the following file at /etc/yum.repos.d/ and run yum install mercurial.

# Temporary until we get a serious signing scheme in place,
# check again

/!\ Mercurial is stable and won't break on automatic updates. Mercurial do however not promise API stability so an update might break extensions or tools using Mercurial internals.

Similar Fedora packages can be built from a Mercurial source repository with commands like make docker-fedora21. "Unsupported" platforms can use contrib/buildrpm directly.

You can also install the package from your distribution

1.5. Linux (others)

1.6. Solaris

1.7. AIX

1.8. BSD

1.9. Plan 9 from Bell Labs

% contrib/install stallion/mercurial

1.10. Other

{i} If you didn't find your favorite distro/package manager above, or if the package version listed on this wiki page seems too old, try

2. Source packages

After getting the source, continue to UnixInstall or WindowsInstall for help with installing.

3. Using pip

Mercurial can also be installed from PyPI with pip, which has shipped with Python since 2.7.9 and 3.4 or can be installed using the instructions on

To install with pip you must have the same C compiler used to compile Python installed as well as the development headers for Python (typically called python-dev or python-devel on Linux).

You may then install Mercurial simply by executing pip install Mercurial.

4. Using conda

Conda is a cross-platform package manager with a focus on Python. You can install mercurial into a python2.7 conda environment with the following invocation:

conda install -c conda-forge mercurial

This should work on OSX, Windows, and Linux. If you would like to update the conda package, see the instructions at

5. Using easy_install

/!\ easy_install is a legacy installation method which has been superseded by pip which should be preferred over easy_install. This method should not be used and is not recommended and will most likely cause conflict with other installs of Mercurial.

Mercurial can also be installed from pypi with easy_install. You will need Python and the C compiler used to build it and easy_install. easy_install might be available in a python-dev or python-setuptools-devel package for your platform or you can grab it from

/!\ Unable to find vcvarsall.bat fix error with mingw and install mercurial 1.7.3 with python 2.7

Create a file in C:\Python26\Lib\distutils and call it distutils.cfg

With the right prerequisites you can install the latest version of Mercurial using:

easy_install -U mercurial

Source repository

You can get Mercurial using Mercurial: my-mercurial-clone
cd my-mercurial-clone
hg up "max(tagged())"
make install


Francais, 中文, 日本語

Download (last edited 2021-10-01 20:25:20 by CarlReinke)