Tip from the team: configuring Git or Mercurial in Sourcetree

Supported Platforms

  • macOS
  • Windows


To make using Sourcetree as simple yet powerful as possible we embed (bundle) dependencies such as Git, Git LFS, and Mercurial. We strive to keep these bundled releases as current as possible but there may be times when you'd like to use a different version than the embedded one.

Mac Prefs 2.pngWindows Prefs.png

It's easy to switch dependencies on either platform, just:

  1. Download and install your preferred dependency (see Additional Resources, below)
  2. Open the Git or Mercurial settings in Sourcetree
  3. Switch to "System" by clicking the appropriate button
  4. Choose the dependency:
    • On macOS, we'll automatically select the default location in a file chooser
    • On Windows, we'll automatically detect default location and only show a file chooser if necessary
  5. Confirm the version information displayed is correct

These changes take effect immediately - you don't need to restart Sourcetree. 

Because the embedded version of a dependency associated with an installed Sourcetree on Windows may not always be the latest preferred version of Git when updating, we recommend following the instructions on this page should the need arise.

Note: we strongly encourage switching back to Embedded Git or Mercurial once it's the same as or newer than your system installation

Additional Resources:


I updated the embedded git to but the Git Tab still shows 2.17.1/LibGit2Sharp

The notification flag still shows the notification to update when I have already done so. The Appdata folder has the updated exe files.


Log in or Sign up to comment
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,237 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