It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

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

Supported Platforms

  • macOS
  • Windows

connected.png

We recently introduced support for additional hosting services such as GitHub Enterprise, GitLab (Cloud, Community Edition, Enterprise Edition), and Visual Studio Team Services. Previously you could use Sourcetree's standard Git functionality but service specific niceties such as remote repository listings with easy cloning, SSH key management, avatars, and perhaps most importantly pull request creation, weren't available. As of 3.0, that's a thing of the past.

This article will walk you through how to set up Sourcetree with your existing account and configure any already checked out repositories to take advantage of this new functionality 🚀

Step 1: Adding your account

To set up a new account for a hosting service you go to the Accounts section of Sourcetree's preferences.

accounts.png
When you click the "Add" or "Edit" buttons you're presented with an account dialog. Here you choose which service (GitLab.com in this example) and then enter the appropriate credentials to use for remote interactions such as repository listings. You also choose the default protocol you prefer to use with this service for remote repository interactions; you can also optionally configure and upload an SSH key based on your username if the service supports it.

Edit.png
Once you save the account Sourcetree will automatically set up the remote repositories listing to populate the next time you visit them. Whenever you clone a repository from that list the rest of this article is taken care of for you 😃

Step 2: Configuring an existing clone of a repository

In the toolbar you'll notice the "Settings" button on the far right. It has a corresponding menu item called "Repository Settings…" under the Repository menu.

toolbar.png

When you click this you're presented with a dialog containing several sections. We're interested in the "Remotes" section, so click on that. You should see a screen similar to this one.

edit_remote.png

If you double-click on the primary remote (origin in this case) or select it and click the "Edit" button you'll be presented with a second screen. 

edit_remote2.png

On this screen you'll want to update the "Optional extended integration" portion to match your repository's host and then add the username which matches your account. Click "OK" to save these and you're good to go. These changes should take effect immediately - you don't need to restart Sourcetree. If you happen to encounter any issues, try closing and re-opening the repository's window/tab to reload it.

Step 3: There's no step three!

Once the extended integration settings are in place for a repository you're ready to go - right click on your current branch and create a pull request for your latest and greatest changes directly from Sourcetree!

Additional Resources:

4 comments

I'm really happy to hear SourceTree added GitLab to list of hosting service! However I've been having trouble adding my GitLab Account.

I tried adding my GitLab account with HTTPS as the protocol but I always get login errors. I have checked my password and I can confirm I was using the correct credentials. Also, is there a way to insert my private token that i've generated?

My team also can't add their GitLab account on SourceTree. I have the latest version of SourceTree v3.0.

gitlab-sourcetree-login-fail.png

Like Ben Styles likes this

Confirming the above by Gerald. I also cannot connect via SSH or HTTPS to gitlab.com account. My gitlab.com account does not have 2FA enabled so that's not a factor. I am also running the latest SourceTree, v.3.0.

Like # people like this

Please file bug reports per this article instead of as comments to ensure they're addressed.

OAuth doesn't work for BitBucket either (Sourcetree 3.0.1) 

Clicking Connect Account SEEMS to work as it sends me to bitbucket's oauth page, but then the account doesn't "stick" or stay connected. 

Trying to sign in the old-fashioned way (username and password) doesn't work either as SourceTree inexplicably requires a NON email address to sign in to bitbucket, but bitbucket REQUIRES an email address to sign in. D'oh!

Finally, trying to add the remote repository directly only generates the dreaded infinite "password required" dialog. Again, it keeps changing my username to the old BitBucket username instead of allowing me to use my email as required.

Welp, off to google now for "Alternatives to Sourcetree". 4 hours of reading and trying unhelpful 'solutions' is enough pain. Maybe someone else has it figured out.

Comment

Log in or Sign up to comment
Community showcase
Published in Sourcetree

Sourcetree for Windows - CVE-2019-11582 - Remote Code Execution vulnerability

A vulnerability has been published today in regards to Sourcetree for Windows.  The goal of this article is to give you a summary of information we have gathered from Atlassian Community as a st...

958 views 0 9
Read article

Community Events

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

Find an event

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

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you