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 hourly snapshot.

• The hg repository is the main development repository - download hourly 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

If you have Python and setuptools installed, you can also use easy_install.

1. Windows

• TortoiseHg all-in-one installer with MS-Explorer integration. Version 0.8 includes Mercurial 1.3 (download, current released installer is TortoiseHg-0.8-hg-1.3.exe)

• Windows installer - latest release, previous builds, snapshots

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

3. Linux (.deb)

• Debian

  • Debian squeeze (testing) - 1.2.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

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

  • Releases - 1.3

  • 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: install with yum install mercurial (see also mercurial-hgk, emacs-mercurial, emacs-mercurial-el) - beta releases

• OpenSUSE - 1.2.1

• Ark Linux - 1.0.2

• OpenPKG - 1.2.1

• CentOS 5: install with yum install mercurial - 1.0

5. Linux (others)

• Arch Linux - 1.2.1

• Gentoo ebuild: install with emerge mercurial - 1.2.1

• T2 SDE - 1.3

• Slackware 12.2 - 1.0.2

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

6. Solaris

• blastwave, solaris 8 to 10 package - 1.0

• sunfreeware.com - SPARC/Solaris 7-10 packages, x86/Solaris 8-10 packages - 1.1.2

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

If you already have Python installed, you can install the latest version of Mercurial using easy_install:

 easy_install -U mercurial 

This is also the easiest way of installing a Mercurial newer than the one provided by your distribution.

If you have Python, but not easy_install, grab it from http://peak.telecommunity.com/DevCenter/EasyInstall.

Note: you may need the python-dev package to run easy_install.