... | ... | @@ -2,17 +2,66 @@ This page has instructions to install Sourcetree, free git client for Windows. |
|
|
|
|
|
For other platforms, see:
|
|
|
|
|
|
- [Sourcetree git client for Mac OSX](Sourcetree-git-client-for-Mac-OSX.md)
|
|
|
- [Sourcetree git client for Mac OSX](Sourcetree-git-client-for-Mac-OSX)
|
|
|
|
|
|
#### Before you begin
|
|
|
|
|
|
You will need access to a git service, so first browse to a git service and login to create your account. Some common git services are:
|
|
|
|
|
|
- Tufts Services
|
|
|
- https://gitlab.tufts.edu
|
|
|
- https://gitlab.it.tufts.edu
|
|
|
- https://gitlab.tufts.edu (Exposed to the Internet)
|
|
|
- https://gitlab.it.tufts.edu (Only accessible from Tufts networks)
|
|
|
- External Cloud Services
|
|
|
- https://github.com
|
|
|
- https://gitlab.com
|
|
|
- https://bitbucket.org
|
|
|
- https://www.codebasehq.com |
|
|
\ No newline at end of file |
|
|
- https://www.codebasehq.com
|
|
|
|
|
|
#### Installing and Configuring SourceTree
|
|
|
|
|
|
- Download SourceTree from <https://www.sourcetreeapp.com/>
|
|
|
- SourceTree is only free if you create an Atlassian account. So create an account and login.
|
|
|
- Install Git. Do not install Mercurial.
|
|
|
![Install Git Not Mercurial](Screen Shot 2018-06-01 at 4.33.12 PM.png)
|
|
|
- When prompted if you already have an ssh key, click No.
|
|
|
![No SSH Key Already](Screen Shot 2018-06-01 at 4.36.05 PM.png)
|
|
|
- Tools > Create or Import SSH Key
|
|
|
![Tools Create or Import SSH Key](Screen Shot 2018-06-01 at 4.38.59 PM.png)
|
|
|
- RSA, 2048, click Generate.
|
|
|
![RSA 2048 Generate](Screen Shot 2018-06-01 at 4.41.24 PM.png)
|
|
|
- Wiggle Mouse in box
|
|
|
![Wiggle Mouse In Box](Screen Shot 2018-06-01 at 4.41.30 PM.png)
|
|
|
- Give your new key a unique name
|
|
|
![Unique Name](Screen Shot 2018-06-01 at 4.47.56 PM.png)
|
|
|
- Copy Public Key
|
|
|
![Copy Public Key](Screen Shot 2018-06-01 at 5.43.32 PM.png)
|
|
|
- Use a text editor, such as Notepad, to save the public key as `id_rsa_public.txt`
|
|
|
![id_rsa_pub.txt](Screen Shot 2018-06-01 at 5.49.56 PM.png)
|
|
|
- On the git service provider, go to your profile, and add your SSH Public Key. For convenience, screenshots are provided showing this on the Tufts Gitlab server:
|
|
|
![Gitlab Profile Menu](Screen Shot 2017-02-28 at 10.25.00 AM.png)
|
|
|
![Paste SSH Public Key](Screen Shot 2017-02-28 at 10.47.49 AM.png)
|
|
|
- Save Private Key
|
|
|
![Save Private Key](Screen Shot 2018-06-01 at 4.51.15 PM.png)
|
|
|
- Yes, save without a password.
|
|
|
![Yes Without Password](Yes Without Password.png)
|
|
|
- Save it as `id_rsa.ppk`
|
|
|
![id_rsa.ppk](Screen Shot 2018-06-01 at 4.51.31 PM.png)
|
|
|
- Conversions > Export openssh key
|
|
|
![export openssh key](Export openssh key.png)
|
|
|
- Yes, save without a password.
|
|
|
![Yes Without Password](Yes Without Password.png)
|
|
|
- Save it as `id_rsa_private_openssh.txt`
|
|
|
![id_rsa_private_openssh](Screen Shot 2018-06-01 at 5.11.48 PM.png)
|
|
|
- Back in SourceTree, go to Tools > Options
|
|
|
![tools options](Screen Shot 2018-06-01 at 5.14.26 PM.png)
|
|
|
- Enter Name, Email, OpenSSH, and `id_rsa_private_openssh.txt`
|
|
|
![name email openssh](Screen Shot 2018-06-01 at 5.15.12 PM.png)
|
|
|
|
|
|
#### Cloning Your First Repo
|
|
|
|
|
|
* Copy the project git URL
|
|
|
![Copy Git URL](Screen Shot 2017-02-28 at 11.45.09 AM.png)
|
|
|
* Click "Clone" in SourceTree
|
|
|
![clone](Screen Shot 2018-06-01 at 5.33.20 PM.png)
|
|
|
* Paste URL
|
|
|
![paste url](Screen Shot 2018-06-01 at 5.58.21 PM.png) |
|
|
\ No newline at end of file |