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:

3 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 1 person 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 2 people like this

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

Comment

Log in or Sign up to comment

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