Clicking 'Clone' link on Bitbucket / Stash doesn't work

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Symptoms

  1. Click a 'Clone in SourceTree' link in Bitbucket or Stash

  2. You receive an error along the lines of 'sourcetree:// doesn't have any registered protocol handlers'

You may also have a similar problem when launching GitHub 'Clone in Mac' links, either the above error or SourceTree not handling the link even though you've enabled it in Preferences > Git.

Cause

Mac OS X's Launch Services database hasn't been updated when SourceTree 1.4 was installed. It appears that the auto-update system (Sparkle) doesn't trigger the database update, but dragging / dropping a new .app into Applications in Finder does.

Resolution

  1. To rebuild your Launch Services database, in a terminal, run the following command:

    1 /System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister -kill -r -domain local -domain system -domain user
  2. Alternatively, re-download SourceTree from the website and drag it from the image into /Applications in Finder, which will cause Launch Services to refresh

Updated on April 8, 2025

Still need help?

The Atlassian Community is here for you.