Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

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.

Thanks for all the additional resources


Log in or Sign up to comment

Atlassian Community Events