Differences between revisions 19 and 118 (spanning 99 versions)
Revision 19 as of 2008-05-02 20:47:15
Size: 1315
Editor: abuehl
Comment: typo
Revision 118 as of 2010-09-08 13:01:43
Size: 7744
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= Download and install from sources = '' (Other languages: [[FrenchDownload|Français]] [[ChineseDownload|中文]] )''
Line 3: Line 3:
This page describes how to download and install Mercurial from sources. <<TableOfContents>>
Line 5: Line 5:
For pre-built packages of Mercurial, see [:BinaryPackages]. = Source packages =
 * Source code of [[WhatsNew|released versions]] of Mercurial can be downloaded as usual .tar.gz files at [[http://mercurial.selenic.com/release/?M=D|http://mercurial.selenic.com/release/]].
 * The [[http://selenic.com/repo/hg-stable|hg-stable]] repository leads to stable releases - download [[http://selenic.com/repo/hg-stable/archive/tip.tar.gz|snapshot]].
 * The [[http://selenic.com/repo/hg|hg]] repository is the main development repository - download [[http://selenic.com/repo/hg/archive/tip.tar.gz|snapshot]].
 * Check DeveloperRepos for other relevant developer repositories where you can clone the hg source.
Line 7: Line 11:
== Getting the sources == After getting the source, continue to UnixInstall or WindowsInstall for help with installing.
Line 9: Line 13:
 * Source code of [:WhatsNew:released versions] of Mercurial can be downloaded as usual .tar.gz files at [http://www.selenic.com/mercurial/release/?M=D http://www.selenic.com/mercurial/release/]. = Binary packages =
== Windows ==
/!\ '''Like TortoiseSVN, [[http://www.selenic.com/pipermail/mercurial/2010-January/029680.html|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:
 * [[http://tortoisehg.bitbucket.org/download/index.html|TortoiseHg with Windows Explorer "shell" integration]] all-in-one installer with !TortoiseHg 1.1.3 and Mercurial 1.6.3 (alternate download: [[http://bitbucket.org/tortoisehg/stable/downloads|Bitbucket]] / [[http://tortoisehg.codeplex.com/releases|CodePlex]])
 * [[http://bitbucket.org/tortoisehg/thg-winbuild/downloads/mercurial-1.6.3.msi|Mercurial-1.6.3 (msi)]], needs admin rights to install.
 * [[http://dl.free.fr/e20FJ2M6T|Mercurial-1.6.3 (exe)]], does not need admin rights to install (InnoSetup based).
 * [[http://cygwin.com/|cygwin]] can install mercurial.
Line 11: Line 22:
 * The [http://selenic.com/repo/hg-stable hg-stable] repository leads to stable releases - download [http://www.selenic.com/mercurial-stable-snapshot.tar.gz hourly snapshot]. Most of the above installers are from [[http://bitbucket.org/tortoisehg/thg-winbuild/downloads/|thg-winbuild]], which has nightly builds of Mercurial and !TortoiseHg - and installers for installing Mercurial as Python packages.
Line 13: Line 24:
 * The [http://selenic.com/repo/hg repo] repository is the main development repository - download [http://www.selenic.com/mercurial-snapshot.tar.gz hourly snapshot]. == Mac OS X ==
 * [[http://mercurial.berkwood.com|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`)
 * [[http://pdb.finkproject.org/pdb/package.php/mercurial-py25|fink]] - 1.2.1
 * [[http://www.macports.org/|macports]]: install with 'sudo port install mercurial' - 1.4.2
Line 15: Line 29:
== Installing from sources ==
Once you have the source code, continue on to:
== Linux (.deb) ==
 * '''Debian'''
  * [[http://packages.debian.org/sid/mercurial|Debian sid (unstable)]] - 1.5.2
  * [[http://packages.debian.org/squeeze/mercurial|Debian squeeze (testing)]] - 1.5.1
  * [[http://packages.debian.org/lenny/mercurial|Debian lenny (stable)]] - 1.0.1
 * '''Ubuntu'''
  * [[http://packages.ubuntu.com/hardy/mercurial|Ubuntu Hardy]] - 0.9.5 ([[http://packages.ubuntu.com/hardy-backports/mercurial|1.0.1]] available if you [[https://help.ubuntu.com/community/UbuntuBackports|enable backports]])
  * [[http://packages.ubuntu.com/intrepid/mercurial|Ubuntu Intrepid]] - 1.0.1
  * [[http://packages.ubuntu.com/jaunty/mercurial|Ubuntu Jaunty]] - 1.1.2
  * [[http://packages.ubuntu.com/karmic/mercurial|Ubuntu Karmic]] - 1.3.1
  * [[http://packages.ubuntu.com/lucid/mercurial|Ubuntu Lucid]] - 1.4.3
  * '''Launchpad PPAs''' (carrying packages for Hardy, Intrepid, Jaunty and Karmic)
   * [[https://launchpad.net/~mercurial-ppa/+archive/releases|Releases]] - 1.6
   * [[https://launchpad.net/~mercurial-ppa/+archive/stable-snapshots|Stable snapshots]] - daily snapshot of stable DeveloperRepos (warning: untested code)
   * [[https://launchpad.net/~mercurial-ppa/+archive/snapshots|Snapshots]] - daily snapshot of unstable DeveloperRepos (warning: untested code)
Line 18: Line 45:
 * WindowsInstall
 * UnixInstall (good for Linux and Mac``OS X, too)
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''.
Line 21: Line 47:
== After installation == == Linux (.rpm) ==
 * [[https://rpmrepo.org/RPMforge/Using|RPMforge]]: packages for RHEL 5 and CentOS 5; install using {{{yum install mercurial}}} - 1.5
 * [[http://rpmfind.net/linux/rpm2html/search.php?query=mercurial&submit=Search+...&system=mandriva&arch=|Mandriva]]: install with {{{urpmi mercurial}}} - 1.2.1
 * [[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.0.2
 * [[http://www.openpkg.org/product/packages/?package=mercurial|OpenPKG]] - 1.2.1
Line 23: Line 56:
In the spirit of [:DistributedSCM: distributed SCM] alternative versions can be found in several DeveloperRepos. An rpm package can be built from a Mercurial source repository with ''contrib/buildrpm''. It has currently mostly been tested on Fedora.
Line 25: Line 58:
Mercurial is developed using Mercurial, so once you have Mercurial up and running you can get the source by [:Clone: cloning] a [:Repository: repository]. Repositories can be browsed with a web browser and will usually have links for downloading as bz2/zip/gz. == Linux (others) ==
 * [[http://archlinux.org/packages/search/?repo=all&category=all&q=mercurial&lastupdate=&limit=50|Arch Linux]] - 1.2.1
 * [[http://packages.gentoo.org/package/dev-util/mercurial|Gentoo ebuild]]: install with {{{emerge mercurial}}} - 1.3.1 (1.4.1 in unstable)
 * [[http://www.t2-project.org/packages/mercurial.html|T2 SDE]] - 1.3
 * [[http://ftp.osuosl.org/pub/slackware/slackware-12.2/slackware/d/|Slackware 12.2]] - 1.0.2
 * [[http://ipkg.nslu2-linux.org/feeds/optware/|Optware cross compilation ipk]] - latest for Python 2.4 and 2.5

== Solaris ==
 * [[http://opencsw.org|OpenCSW]]: [[http://opencsw.org/packages/mercurial|mercurial-1.3.1]], [[http://mirror.opencsw.org/testing.html|testing contains mercurial-1.4.1]], for Solaris 8-10, SPARC/x86.
 * [[http://www.blastwave.org/pkg/search.ftd?qs=mercurial|blastwave]] - 1.3.1
 * [[http://sunfreeware.com|sunfreeware.com]] - SPARC/Solaris 2.6-10 packages, x86/Solaris 8-10 packages - 1.5

== AIX ==
 * [[http://www.lunch.org.uk/wiki/aix_packages|Mercurial and supporting RPMs, for AIX 5.2 and later]] - 1.6.3

== BSD ==
 * [[http://freebsd.org/cgi/url.cgi?ports/devel/mercurial/pkg-descr|FreeBSD Mercurial port]] ([[http://freebsd.org/cgi/cvsweb.cgi/ports/devel/mercurial/|port-webdir]]). [[ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-stable/devel/mercurial-1.2.1.tbz|i386 package]] - 1.2.1
  * Requires [[http://freebsd.org/cgi/cvsweb.cgi/ports/lang/python25/|python25]] (i386 package: [[ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-stable/lang/python25-2.5.2_1.tbz|python25-2.5.2_1.tbz]]). 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.
 * [[ftp://ftp.netbsd.org/pub/pkgsrc/current/pkgsrc/devel/mercurial/README.html|NetBSD]] packages compiled from [[http://pkgsrc.se/devel/mercurial|pkgsrc]] - 1.2.1

= Using easy_install =
Mercurial can also be installed from [[http://pypi.python.org/pypi/Mercurial/|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
}}}

(Other languages: Français 中文 )

Source packages

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:

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)

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)

6. Solaris

7. AIX

8. BSD

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

Download (last edited 2021-10-01 20:25:20 by CarlReinke)