General FAQ

Installation Questions

What's this about registration?

SourceTree is free, but we ask you to register it (for free, natch) after 30 days.

Can I use my license file from the Mac and Windows version on a different platform?

Yes, just click 'Import License' on the registration dialog and you can import your existing Mac license, it'll work fine.

Should I use HTTPS or SSH to clone repositories?

It's up to you; SourceTree supports both. HTTPS is easier to set up, and SourceTree will offer to save your passwords for you (encrypted of course), but SSH can be more convenient once you have keys set up.

Windows FAQ

What versions of Windows are supported?

SourceTree for Windows supports Windows 7 upwards.

How do I install SourceTree for Windows?

Download the setup program then run it. Accept any confirmation messages and wait for the download of any required components to complete. If you are on Windows 7 and have never installed .Net 4.5 before, you may be asked to reboot (Windows 8 comes with this pre-installed). You need administrator rights to install SourceTree but once installed any user can run it.

Visual C++ 2010's resource compiler is reporting a LNK1123 error after installing SourceTree, what happened?

This is a rare problem, most VC++ 2010 users don't encounter it, but Microsoft's .Net 4.5 runtime (which SourceTree depends on) can interfere with the VC++ 2010 resource compiler if you haven't installed Visual Studio 2010 Service Pack 1. The resolution is to simply install Visual Studio 2010 Service Pack 1 which fixes this issue. If you think you already have SP1 installed and still have this problem, you should reinstall SP1 because in very rare cases this is needed after .Net 4.5 is installed. More info is on Microsoft's Knowledge Base.

What are the other differences between the Mac version and the Windows version?

As at the time of writing (version 0.8b) the following features from the Mac version are missing from the Windows port:

  • git-svn
  • Binary file previews
  • Listing & creating projects on Bitbucket, Stash and GitHub
  • JIRA and other link parsing in commit messages
  • Custom Actions
  • Patch handling
  • Probably lots of other little things!

But, we'll be working on these and will bring them to you as soon as we can!

Getting Started

How do I add my repositories to SourceTree?

Drag and drop existing repository folders from Explorer into the Bookmarks pane on the left of the window. Alternatively, click the 'Clone/New' toolbar button, where you can choose to clone repositories, add them from your local disk, or create brand new ones.

How do I view a repository?

Double-click a bookmark to open it - you can have as many repositories open at a time as you like in the tabbed interface. You can also use the File > Open menu if you want to open a repository without bookmarking it.

What are the different views in a repository?

There is an inner tab interface per repository with tabs at the bottom, labelled 'File Status', 'Log / History' and 'Search'. You can click to switch, or use Ctrl-1/2/3. The File Status view gives you the most space to review your current changes, the Log / History view shows you the full history of the project, but can also have an 'Uncommitted Changes' line to show your current changes in context, and the Search view is for digging into the history for specific changes.

All the views should automatically refresh when they detect filesystem changes, but you can manually refresh too.

How do I stage changes for commit?

You can do this many ways:

  • Drag and drop files from the bottom 'Working Copy' pane of the file status view to the top 'Staged Changes' pane.
  • Right-click files in the 'Working Copy' pane and select 'Add to index'
  • In the diff view on the right, click 'Stage File' to stage the whole file, 'Stage Hunk' to stage just the changes in a single hunk, or select a range of lines and click 'Stage Selected Lines'

How do I set up SSH keys for authentication?

SourceTree uses the PuTTY suite of Windows-friendly SSH tools, here's how you get set up:

  1. If you already have a PuTTY key file (.ppk), skip to step 7
  2. From the SourceTree menu, select Tools > Create or Import SSH Keys
    If you use Windows 8 and SmartScreen is enabled, PuTTYgen may be blocked. Click 'More Info' and then 'Run'
  3. If you already have an OpenSSH key (e.g. ~/.ssh/id_rsa)

    1. In the PuTTYgen menu, click Conversions > Import Key
    2. Browse to your OpenSSH private key, it's likely in %USERPROFILE%\.ssh\id_rsa
    3. This will import your OpenSSH key (you'll need to type its passphrase) for use with the PuTTY suite.
  4. Otherwise, you need to create a new key:

    1. Click 'Generate', then move your mouse randomly while it generates a key for you.
    2. Type in a long but memorable key passphrase in the 2 boxes supplied. This will protect your key file from others.
  5. Click 'Save Private Key' and save it somewhere you won't lose it
  6. Click 'Save Public Key' and save it in the same place
  7. To avoid typing the passphrase every time, you'll want to use the background agent to hold your keys, which is called 'Pageant'. You can launch this now from the SourceTree menu under Tools > Launch SSH Agent.
  8. Browse to your private key file (.ppk) and type the passphrase when prompted
  9. If you want Pageant to start when you log in, please see these instructions.
  10. Whenever you need to add your SSH key to a service such as Bitbucket, you simply need to copy and paste your public key, either from the public key file you saved above, or from the panel in the PuTTYgen window (you can re-load your key into PuTTYgen any time).