#pragma section-numbers 2 = Download = Source archives and binary packages for various systems. See WhatsNew for information on upgrading. <> == Binary packages == === Windows === /!\ '''Like TortoiseSVN, [[https://www.mercurial-scm.org/pipermail/mercurial/2010-January/029680.html|we recommend]] turning off the indexing service on the working copies and repositories, and excluding them from virus scans.''' * Windows installers are available on the [[https://www.mercurial-scm.org/downloads|downloads page]] === Mac OS X === * Mac OS X packages are available on the [[https://www.mercurial-scm.org/downloads|downloads page]] * [[http://pdb.finkproject.org/pdb/package.php/mercurial|Fink]]: install with 'fink install mercurial' - 3.3 * [[https://trac.macports.org/browser/trunk/dports/devel/mercurial/Portfile|macports]]: install with 'sudo port install mercurial' - 3.3 * [[https://github.com/Homebrew/homebrew-core/blob/master/Formula/mercurial.rb|homebrew]]: install with 'brew install mercurial' - 3.8.1 * TortoiseHg for Mac available [[https://bitbucket.org/tortoisehg/files/downloads|here]] - 3.7.3 === Linux (.deb) === * '''Debian''' * [[https://packages.debian.org/sid/mercurial|Debian sid (unstable)]] - 5.5.2 * [[https://packages.debian.org/bullseye/mercurial|Debian bullseye (testing)]] - 5.5.2 * [[https://packages.debian.org/buster/mercurial|Debian buster (stable)]] - 4.8.2 * [[https://packages.debian.org/stretch/mercurial|Debian stretch (oldstable)]] - 4.0 * '''Ubuntu''' * [[https://packages.ubuntu.com/groovy/mercurial|Ubuntu Groovy]] - 5.5.1 * [[https://packages.ubuntu.com/focal/mercurial|Ubuntu Focal]] - 5.3.1 * [[https://packages.ubuntu.com/bionic/mercurial|Ubuntu Bionic]] - 4.5.3 * [[https://packages.ubuntu.com/xenial/mercurial|Ubuntu Xenial]] - 3.7.3 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--` (e.g. `docker-debian-stretch` or `docker-ubuntu-bionic`, see Source: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 [[https://stackoverflow.com/a/15773831/410713|stackoverflow]]) === Linux (.rpm) === Since Mercurial version 3.4, the Mercurial project provides packages for the following systems: * [[http://www.mercurial-scm.org/release/centos5/RPMS/x86_64/|Centos 5]] (includes a python2.7 install) * [[http://www.mercurial-scm.org/release/centos6/RPMS/x86_64/|Centos 6]] * [[http://www.mercurial-scm.org/release/centos7/RPMS/x86_64/|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 * [[http://rpmfind.net/linux/rpm2html/search.php?query=mercurial&submit=Search+...&system=mandriva&arch=|Mandriva]]: install with {{{urpmi mercurial}}} - latest revision available * [[http://koji.fedoraproject.org/koji/packageinfo?packageID=2518|Fedora]] - latest version is available within few days after release, install with {{{yum install '*mercurial}}}*' * [[http://fedoraproject.org/wiki/EPEL|Fedora Projects EPEL]] for RHEL and CentOS 5: 1.3.1, install with {{{yum install '*mercurial}}}*' * [[http://download.opensuse.org/repositories/devel:/tools:/scm/|openSUSE]] - latest version is available shortly after release in the `devel:tools:scm` repository * [[http://arklinux.osuosl.org/dockyard-devel/SRPMS/|Ark Linux]] - 1.6.2 * [[http://www.openpkg.org/product/packages/?package=mercurial|OpenPKG]] - 1.4 === Linux (others) === * [[http://archlinux.org/packages/?q=mercurial|Arch Linux]] - 4.6.2 * [[http://packages.gentoo.org/package/dev-vcs/mercurial|Gentoo ebuild]]: install with {{{emerge mercurial}}} - 4.6.2 * [[http://www.t2-project.org/packages/mercurial.html|T2 SDE]] - 4.6.2 * [[http://slackware.osuosl.org/slackware-current/slackware/d/|Slackware]] - 4.6.2 * [[http://ipkg.nslu2-linux.org/feeds/optware/|Optware cross compilation ipk]] - latest for Python 2.4 and 2.5 === Solaris === * [[http://unixpackages.com/packages/package-matrix?frm_search=mercurial|unixpackages.com]] - SPARC/Solaris 2.6-10 packages, x86/Solaris 8-11 packages - 2.3 (8 & 9), 4.2 (10 & 11) * [[http://www.opencsw.org|OpenCSW]]: [[http://www.opencsw.org/packages/mercurial|solaris package mercurial-3.8.2, sparc/solaris, x86/solaris]]. === AIX === * [[http://www.lunch.org.uk/wiki/aix_packages|Mercurial for AIX 5.2 and later]] - 3.0.2 === BSD === * [[http://www.freebsd.org/cgi/cvsweb.cgi/ports/devel/mercurial/|FreeBSD]]; use [[http://freebsd.org/cgi/man.cgi?query=pkg_add&apropos=0&sektion=0&manpath=FreeBSD+6.3-RELEASE&format=html|pkg_add]] for installing - 4.6 (on 2018-07-16) * [[ftp://ftp.netbsd.org/pub/pkgsrc/current/pkgsrc/devel/mercurial/README.html|NetBSD]] packages compiled from [[http://pkgsrc.se/devel/mercurial|pkgsrc]] - always very up-to-date, currently 4.6.1 === Plan 9 from Bell Labs === * To build from source, see: Plan9FromBellLabs * Binary packages are available from fgb's contrib: {{{ % contrib/install stallion/mercurial }}} === 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 https://repology.org/metapackage/mercurial/versions. == Source packages == * Source code of [[WhatsNew|released versions]] of Mercurial can be downloaded as usual .tar.gz files at [[https://www.mercurial-scm.org/release/?M=D|https://www.mercurial-scm.org/release/]]. * The [[http://mercurial-scm.org/repo/hg-stable|hg-stable]] repository leads to stable releases - download [[http://mercurial-scm.org/repo/hg-stable/archive/tip.tar.gz|snapshot]]. * The [[http://mercurial-scm.org/repo/hg|hg]] repository is the main development repository - download [[http://mercurial-scm.org/repo/hg/archive/tip.tar.gz|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. == Using pip == Mercurial can also be installed from [[https://pypi.python.org/pypi/Mercurial|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}}}. == 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 == 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 [[https://pypi.python.org/pypi/Mercurial/|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. /!\ [[http://code.google.com/p/rdflib/issues/detail?id=104|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 }}} = Source repository = You can get Mercurial using Mercurial: {{{ https://www.mercurial-scm.org/repo/hg/ my-mercurial-clone cd my-mercurial-clone hg up "max(tagged())" make install }}} ---- CategoryProject [[FrenchDownload|Francais]], [[ChineseDownload|中文]], [[JapaneseDownload|日本語]]