(Other languages: Français 中文 )

Source packages

• Source code of released versions of Mercurial can be downloaded as usual .tar.gz files at http://mercurial.selenic.com/release/.

• The hg-stable repository leads to stable releases - download snapshot.

• The hg repository is the main development repository - download snapshot.

• Check DeveloperRepos for other relevant developer repositories where you can get clone the hg source.

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

Binary packages

1. Windows

Like TortoiseSVN, we recommend to turn off the indexing service on the working copies and repositories, and exclude them from virus scans.

• [http://portableapps.com/node/23367 Mercurial Portable], does not need admin privileges.

• TortoiseHg with Windows Explorer "shell" integration

  • Download all-in-one installer with TortoiseHg 1.0.4 and Mercurial 1.5.4 (alternate download)

  • Mercurial-1.5.4 installer without TortoiseHg

  • thg-winbuild has nightly builds of Mercurial and TortoiseHg - and installers for installing Mercurial as Python packages

• cygwin can install mercurial.

2. Mac OS X

• Mac OS X packages (you may have to add export LC_ALL=en_US.UTF-8 and export LANG=en_US.UTF-8 to your ~/.profile)

• fink - 1.2.1

• macports: install with 'sudo port install mercurial' - 1.4.2

3. Linux (.deb)

• Debian

  • Debian sid (unstable) - 1.5.2

  • Debian squeeze (testing) - 1.5.1

  • Debian lenny (stable) - 1.0.1

• Ubuntu

  • Ubuntu Hardy - 0.9.5 (1.0.1 available if you enable backports)

  • Ubuntu Intrepid - 1.0.1

  • Ubuntu Jaunty - 1.1.2

  • Ubuntu Karmic - 1.3.1

  • Ubuntu Lucid - 1.4.3

  • Launchpad PPAs (carrying packages for Hardy, Intrepid, Jaunty and Karmic)

    • Releases - 1.5

    • Stable snapshots - daily snapshot of stable DeveloperRepos (warning: untested code)

    • Snapshots - daily snapshot of unstable DeveloperRepos (warning: untested code)

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.

4. Linux (.rpm)

• Mandriva: install with urpmi mercurial - 1.2.1

• Fedora and CentOS 5 with Fedora Projects EPEL: install with yum install '*mercurial*' - 1.4.1 (EPEL 1.3.1)

• OpenSUSE - 1.2.1

• Ark Linux - 1.0.2

• OpenPKG - 1.2.1

An rpm package can be built from a Mercurial source repository with contrib/buildrpm. It has currently mostly been tested on Fedora.

5. Linux (others)

• Arch Linux - 1.2.1

• Gentoo ebuild: install with emerge mercurial - 1.3.1 (1.4.1 in unstable)

• T2 SDE - 1.3

• Slackware 12.2 - 1.0.2

• Optware cross compilation ipk - latest for Python 2.4 and 2.5

6. Solaris

• OpenCSW: mercurial-1.3.1, testing contains mercurial-1.4.1, for Solaris 8-10, SPARC/x86.

• blastwave - 1.3.1

• sunfreeware.com - SPARC/Solaris 2.6-10 packages, x86/Solaris 8-10 packages - 1.5

7. AIX

• Mercurial and supporting RPMs, for AIX 5.2 and later - 1.5.4

8. BSD

• FreeBSD Mercurial port (port-webdir). i386 package - 1.2.1

  • Requires python25 (i386 package: python25-2.5.2_1.tbz). Use pkg_add for installing.

• NetBSD packages compiled from pkgsrc - 1.2.1

Using easy_install

Mercurial can also be installed from pypi with easy_install. It will however mostly just download and make a partial installation from source as described above. The installation will not be complete, and there have been reports that it doesn't work on OS X.

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 http://peak.telecommunity.com/DevCenter/EasyInstall.

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

easy_install -U mercurial