Make it easier to upgrade SourceTree Mercurial

I have just spent several hours in order to upgrade SourceTree Mercurial, something which should be a trivial process with a teeny bit more help from SourceTree to know where to look.

Every time I started SourceTree recently I got the message telling me that the recommended level of Mercurial was >= 3.7.3, but nowhere in the message did it even give me the basic information that I needed to look in "Tools -> Options -> Mercurial". Adding that in the message would have saved me hours. Adding the link directly to the right Options page would have saved me even another minute looking. Not just detecting that Mercurial is out of date, but offering me a "Update Embedded Mercurial" button there in the message would have saved me even this.

I tried the SourceTree update; said my SourceTree was up to date. I went to the internet and researched Mercurial. I downloaded Mercurial and installed. Restarted SourceTree. Rebooted my machine. Reinstalled Mercurial. Went round and round this loop a few times. Looked on my C: drive. Found I had two versions of Mercurial (one in "Program Files\TortoiseHg" directory, one in "Program Files\Mercurial" directory), but both seemed to be the latest.

I eventually found it in the Options menu, found I was using "Embedded Mercurial" and clicked "Update Embedded Mercurial" and 2 seconds later, the job was done.

It's only because we are IT people using SourceTree that we have learnt to be so determined to find how to fix things.

Please though, use the information that SourceTree knows (e.g. where the exact option panel is) to help us not have to spend so much time looking! 

Thank you!

3 answers

Definitely second this!  I didn't spend as much time as Hugh on this before coming here, but your error message is completely unhelpful and more than likely to send people the wrong way. (ie updating their installation of Mercurial which is exactly what I did)

I have stumbled on to this only after allowing SourceTree to update itself.  Now when I start SourceTree I am presented with the warning of the security warning from Mercurial, that I need to upgrde from 3.2.3 to 3.7.3 and then SourceTree promptly exits.  I uninstalled/reinstalled SourceTree to no avail.  I do not use Mercurial stand alone, so I assume it is embedded with SourceTree...  This update has hung me out to dry......  It is not obvious what I need to do clear this conundrum.

Here's the secret (which took me hours to unlock):

  • look in "Tools -> Options -> Mercurial"
  • click "Update Embedded Mercurial"


Yeah this got me for weeks. Trying to create a support ticket or find an email to support was impossible. The whole thing is a shambles. Link after link taking me no closer to real contact with anyone who might help. So glad I finally stumbled across this. Seeing help in the form of discontent is apt

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Oct 23, 2018 in Sourcetree

Tip from the team: configure your repos for hosting goodness!

Supported Platforms macOS Windows We recently introduced support for additional hosting services such as GitHub Enterprise, GitLab (Cloud, Community Edition, Enterprise Edition), and...

1,225 views 4 2
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you