step-by-step install Mercurial on OSX, Ubuntu and Windows

This is an add-on to part 1 of my DVCS – blogseries. On demand I’ll describe my way how to install Mercurial on OSX, Ubuntu and Windows.

I really hope one day we can do all from inside Eclipse using HgEclipse – but for now it’s good to have Mercurial itself installed 😉

Install Mercurial on OSX

The easiest way is to download from here:

select the version you need (OSX 10.5 or 10.6) – the following is the same as with 1.4.3 so I didn’t replaced the screenshots.

Unzip and Doubleclick the Installer:

Here’s an important information you need later: the hg executable was installed in


Next” … “Finish” the Installer.

Open the Terminal Application on OSX and type

hg --version

you should get:


you’re ready – Mercurial is installed on OSX.

Install Mercurial on Ubuntu

Ubuntu 9.1.0 should already be prepared for Mercurial, so you can install hg easy:

sudo apt-get install mercurial
hg --version

if the version gives you something less then 1.6.0 you should update to Mercurial 1.7.1, its easy:

Go to System -> Administration -> Software Sources:

then choose “Other Software“, “Add“:

and add “ppa:mercurial-ppa/releases“:

Hit “Add Source” and “Close” – now a Dialog appears:

Please hit “Reload” – now Open “System Administration Update Manager” – Mercurial should be listed there:

"Install Updates" and open the Terminal Appliction, then type
hg --version

you should get:


You’re done: latest Mercurial is installed on your Ubuntu 🙂

Install Mercurial on Windows

To install Mercurial for Windows you can use the same page as for OSX described above:

Download and double-click the Installer:


go through the default installation:


Hit “Finish” and you’re ready. Open “Cmd” and type:

hg --version

you should get:


Now you’re done – Mercurial is installed on Windows.

use of ssh

if working with Remote Repositories of Git or Mercurial you have to use ssh. How to install and use ssh, ssh -keygen… will be demonstrated in another post.

The overview of my blog seriesabout DVCS can be found here:

3 responses

  1. Pingback: DVCS: MercurialEclipse Release 1.7.0 – great release with Updatesite trouble « ekkes-corner: eclipse | osgi | mdsd | erp | mobile

  2. Thanks for this blog series. I can honestly say we wouldn’t have been able to switch to Mercurial as easily and quickly without the help we received from your blog, especially regarding Eclipse integration which is crucial for us.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s