- SourceTree uses the git 'protocol' to do it's job. Own, internal, implementation of the git 'protocol'). This means that you can install SourceTree, but if you don't install the git softare that SourceTree uses then SourceTree can't work.
Introduction We will discuss a quick tip to resolve the SourceTree issue mentioned in the title. Background My system got upgraded to Windows 8.1 and I had to install all required software for the development work.
This tutorial shows you how to connect Sourcetree and Gitlab
- Open Sourcetree, if you have not installed it yet go to Installing Sourcetree and finish that tutorial first
- That will open the following window:
- after this you should get a window that looks like this:
- You can save the keys anywhere on your hard drive, just make sure you remember where you put them.
- Then open a browser and go to https://gitlab.lrz.de/ and log in using your LRZ user name (aa11bbb)
- Now you can close the window in which you create the key and go to Tools/options in Sourcetree
- The Pageant client should be running now, if you do not see the symbol, extend the taskbar
- Now sourcetree can access gitlab but you do not have any projects in Sourcetree yet. In order to download or upload code you need to have a project.
- This tutorial will show you how to get the base V-HAB project into sourcetree, the steps to get any other project into sourcetree are basically the same.
- First go to the gitlab project you want to download, in this case STEPS-base, the website should look like this:
- After that just hit the clone button at the bottom of the window and you will receive the project. Now your Sourcetree should be connected to gitlab and you are able to download code from gitlab or upload code to gitlab
For instruction on how to use Sourcetree go to the next tutorial
If you want to access GitLab via SourceTree, you can connect it with an account profile now. Another method is to connect GitLab by using the clone function with SSH key.
What Will We Learn (Method 1)
- Access GitLab with personal access token
What Will We Learn (Method 2)
- Create SSH key
- Access GitLab via SourceTree with SSH key
Method 1: Connect with Remote (Account Profile)
Since SourceTree 3.0, it adds support for additional remote hosting services. They are GitHub Enterprise, Microsoft Visual Studio Team Services, and GitLab (Cloud, CE, EE).
Create Personal Access Token
To connect GitLab with Remote, personal access token is required for authentication. To create personal access token, login GitLab and go to Settings.
After that, select Access Tokens from the sidebar. You will create your personal access token here. Give access token a name. You are able to set an expiry date for your access token. By leaving it blank, access token will never expire. Next check the api and read_user checkbox, it is required for SourceTree to connect to GitLab remotely. Click on Create personal access token to complete the setup.
Next open up your SourceTree, click on Remote and click on Add an account.
Select GitLab as the hosting services, and choose HTTPS as the Preferred Protocol. Click on Refresh Personal Access Token.
Sourcetree Not Installed
You will be prompted to enter the username and password. After entering the username and password then press OK to continue.
Do take note that email address you used to login GitLab is not your username. If you do not know your username. Go to GitLab and click on the top right profile icon. The text after @ is your username. In this example, it would be aword-test.
Furthermore, the password is your personal access token code. It only shows you once you created your personal access token. Make sure save your personal access token code in a safe place.
Then you have completed the steps to connect GitLab with SourceTree. If you connect successfully, you will able to see your repositories in SourceTree.
Method 2: Connect with SSH Key
This method is useful for users who are not using SourceTree 3.0 and above.
What is SSH Key
The Secure Shell (SSH) key is based on the principle of Public-key cryptography. It is used as a way of authentication. By generating an SSH key pair, you will get a private key and a public key. You can image public key as a padlock. You can distribute it to any systems on the Internet. Private key is like a key of the padlock. You should keep the private key securely and avoid it from being compromised. To access any system with public key, you need to use the private key to authenticate yourself.
Create SSH Key
To create SSH key, you need to generate your own SSH key with SourceTree. Go to Tools and select Create or Import SSH Keys.
Click on Generate to create SSH Key. Move your mouse cursor within the PuTTY Key Generator continuing to generate the SSH Key.
Can't Install Sourcetree Windows 10
After SSH Key is generated, type your own Key passphrase for your SSH Key. Key passphrase is like a password to protect your SSH private key. Save your public key and private key for future use.
Add SSH Public Key to GitLab
To add your SSH Key to GitLab, you need to log into you GitLab account. Click on your profile icon on the top right corner, then select Settings. Click on SSH Keys on the side menu.
Copy your public key inside your PuTTY Key Generator, then paste it into GitLab. Click on Add Key to add your SSH Key into the GitLab.
Add SSH Private Key to SourceTree
To add private key to SourceTree, Click on Tools then click Launch SSH Agent…
You will find SSH Agent named as Pageant on the taskbar. Double click on Pageant. Turquoise task chair.
Now click on Add Key. Add your private key which have been saved earlier.
Clone Repository to Access GitLab via SourceTree
Go into your projects in your GitLab. Copy the SSH URL.
In SourceTree, click on Clone. Paste the repository URL into Source Path. Click on Clone, you have successfully connected GitLab with SourceTree. Now you are able to pull and push your code to GitLab with SourceTree.