(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 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. The following installers can be used from Win2K on:

• TortoiseHg with Windows Explorer "shell" integration all-in-one installer with TortoiseHg 1.1.3 and Mercurial 1.6.3 (alternate download: Bitbucket / CodePlex)

• Mercurial-1.6.3 (msi), needs admin rights to install.

• Mercurial-1.6.3 (exe), does not need admin rights to install (InnoSetup based).

• cygwin can install mercurial.

Most of the above installers are from thg-winbuild, which has nightly builds of Mercurial and TortoiseHg - and installers for installing Mercurial as Python packages.

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.6

    • 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)

• RPMforge: packages for RHEL 5 and CentOS 5; install using yum install mercurial - 1.5

• Mandriva: install with urpmi mercurial - 1.2.1

• Fedora - latest version is available within few days after release, install with yum install '*mercurial*'

• Fedora Projects EPEL for RHEL and CentOS 5: 1.3.1, install with yum install '*mercurial*'

• openSUSE - latest version is available shortly after release in the devel:tools:scm repository

• 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.6.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