Appendix C. Installing Mercurial from Source

On a Unix-Like System

If you are using a Unix-like system that has a sufficiently recent version of Python (2.3 or newer) available, it is easy to install Mercurial from source. Here’s how:

  1. Download a recent source tarball from http://www.selenic.com/mercurial/download.

  2. Unpack the tarball:

    gzip -dc mercurial-MYVERSION.tar.gz | tar xf -
  3. Go into the source directory and run the installer script. This will build Mercurial and install it in your home directory.

    cd mercurial-MYVERSION
    python setup.py install --force --home=$HOME

Once the install finishes, Mercurial will be in the bin subdirectory of your home directory. Don’t forget to make sure that this directory is present in your shell’s search path.

You will probably need to set the PYTHONPATH environment variable so that the Mercurial executable can find the rest of the Mercurial packages. For example, on my laptop, I have set it to /home/bos/lib/python. The exact path that you will need to use depends on how Python was built for your system, but should be easy to figure out. If you’re uncertain, look through the output of the installer script above, and see where the contents of the mercurial directory were installed to.

Get Mercurial: The Definitive Guide now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.