Download

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.

The following installers can be used from Windows XP onwards:

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

• Mercurial-3.8.3 (32-bit msi) / Mercurial-3.8.3 (64-bit msi), needs admin rights to install, less friendly with manually installed extensions than InnoSetup version

• Mercurial-3.9-rc (32-bit exe) / Mercurial-3.9-rc (64-bit exe), does not need admin rights to install (InnoSetup based).

• Mercurial-3.8.3 (32-bit py2.7) / Mercurial-3.8.3 (64-bit py2.7), installs Mercurial source as Python modules and thus requires Python 2.7 installed. This is recommended for hgweb setups and extensions with non-standard dependencies.

• cygwin can install Mercurial, but the cygwin abstraction layers introduces a potential source of error and is not really recommended.

• HackableMercurial is a self-contained install that allows easy hacking on the Mercurial source and testing of unreleased versions

Most of the above installers are from thg-winbuild, which has nightly builds of Mercurial and TortoiseHg.

1.2. Mac OS X

• Mac OS X packages are available on the downloads page

• Fink: install with 'fink install mercurial' - 3.3

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

• homebrew: install with 'brew install mercurial' - 3.8.1

• TortoiseHg for Mac available here - 3.7.3

1.3. Linux (.deb)

• Debian

  • Debian sid (unstable) - 3.8.1.

  • Debian stretch (testing) - 3.7.3

  • Debian jessie (stable) - 3.1.2 (plus security; 3.7.3 available as a jessie-backport).

  • Debian wheezy (oldstable) - 2.2.2. (3.1.1 available as a wheezy backport)

  • Debian squeeze - 1.6.4 (2.2.2 available as a squeeze backport)

• 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

  • Ubuntu Maverick - 1.6.3-1

  • Ubuntu Natty - 1.7.5-1ubuntu1

  • Ubuntu Precise - 2.0.2-1ubuntu1

  • Ubuntu Trusty - 2.8.2-1ubuntu1.3

  • Ubuntu Wily - 3.4-1ubuntu2

  • Ubuntu Xenial - 3.7.3-1ubuntu1

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.

1.4. Linux (.rpm)

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

• Centos 5 (includes a python2.7 install)

• Centos 6

• Centos 7

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/mercurial.selenic.com.repo and run yum install mercurial.

[mercurial.selenic.com]
name=mercurial.selenic.com
baseurl=https://www.mercurial-scm.org/release/centos$releasever
enabled=1
# Temporary until we get a serious signing scheme in place,
# check https://www.mercurial-scm.org/wiki/Download again
gpgcheck=0

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

• Mandriva: install with urpmi mercurial - latest revision available

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

• OpenPKG - 1.4

1.5. Linux (others)

• Arch Linux - 3.8.3

• Gentoo ebuild: install with emerge mercurial - 2.4.2 (2.5.1/2.6 in unstable)

• T2 SDE - 3.0.2

• Slackware 14.1 - 2.7.2

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

1.6. Solaris

• unixpackages.com - SPARC/Solaris 2.6-10 packages, x86/Solaris 8-11 packages - 2.3 (8 & 9), 3.4 (10 & 11)

• OpenCSW: solaris package mercurial-3.8.2, sparc/solaris, x86/solaris.

1.7. AIX

• Mercurial for AIX 5.2 and later - 3.0.2

1.8. BSD

• FreeBSD; use pkg_add for installing - 3.7 (on 2016-04-13)

• NetBSD packages compiled from pkgsrc - always very up-to-date, currently 2.6

1.9. Plan 9 from Bell Labs

• To build from source, see: Plan9FromBellLabs

• Binary packages are available from fgb's contrib:

% contrib/install stallion/mercurial

2. Source packages

• Source code of released versions of Mercurial can be downloaded as usual .tar.gz files at https://www.mercurial-scm.org/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.

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 https://pip.pypa.io/en/stable/installing.html.

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 https://github.com/conda-forge/mercurial-feedstock

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

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
[build]
compiler=mingw32

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

easy_install -U mercurial

CategoryProject

Français, 中文, 日本語