This guide is intended to get you up and running in !TortoiseGit for Windows. It will take you through installation, and key creation.

'''Note:''' this guide was created on a 32-bit Windows XP SP2 machine.
Some steps may differ slightly on other operating systems.
In particular, most Vista and Windows 7 machines are 64-bit rather than 32-bit,
so you will need the 64-bit version of !TortoiseGit (linked in the instructions below).

= Installation =

== Git for Windows ==

Git is the software that talks to the remote repository, tracks your local changes, and so forth.

Start by downloading [http://code.google.com/p/msysgit/downloads/detail?name=Git-1.7.11-preview20120710.exe&can=2&q=full+installer+official+git Git for Windows 1.7.11]
and !TortoiseGit 1.7.11.3 ([http://code.google.com/p/tortoisegit/downloads/detail?name=TortoiseGit-1.7.11.3-32bit.msi&can=2&q= 32-Bit] or [http://code.google.com/p/tortoisegit/downloads/detail?name=TortoiseGit-1.7.11.3-64bit.msi&can=2&q= 64-Bit])

You should have the following files when you're done:

[[Image(file-list.png)]]

Run '''Git-1.7.11-preview20120710.exe''' to start Git installation.

[[Image(git-1.png)]]

The default settings should be OK.

[[Image(git-2.png)]]

[[Image(git-3.png)]]

[[Image(git-4.png)]]

[[Image(git-5.png)]]

Git Installation is complete! Let's move on to !TortoiseGit.

== TortoiseGit ==

Run '''!TortoiseGit-1.7.11.3-32bit.msi''' (or '''!TortoiseGit-1.7.11.3-64bit.msi''' if you're on a 64-bit system) to begin !TortoiseGit installation

[[Image(tortoisegit-1.png)]]

Once again, the default options should be OK.

[[Image(tortoisegit-2.png)]]

[[Image(tortoisegit-3.png)]]

!TortoiseGit installation is complete! Let's move on to creating your public/private key pair.

= !Public/Private Key Creation =

Browse to the folder where you installed '''!TortoiseGit'''. By default, this will be '''C:\Program Files\!TortoiseGit\'''

Open the '''bin''' folder inside the TortoiseGit folder and located '''puttygen.exe'''

[[Image(puttygen-location.png)]]

Run '''puttygen.exe'''

[[Image(puttygen-1.png)]]

Click the ''''Generate'''' button. You'll be asked to move your mouse around for a bit while a progress bar fills up. This helps make your key more random (which makes it harder for someone else to impersonate you).

[[Image(puttygen-2.png)]]

When the progress bar finishes, your key will appear. Enter a password (twice) before continuing.

[[Image(puttygen-3.png)]]

First click ''''Save Public Key'''' and save your key somewhere. I've saved mine as ''''public.ppk'''' in my Application Data/ssh folder, but you can put this anywhere. Just keep it somewhere safe where you can find it later.

[[Image(puttygen-4.png)]]

Next click ''''Save Private Key'''' and save your key somewhere. I recommend putting it in the same place as your public key. I've named mine ''''private.ppk''''. '''Remember:''' your private key never leaves your computer! Only your '''public key''' gets shared with anyone.

[[Image(puttygen-5.png)]]

Now that you've saved your public/private key pair, copy the ''''Public key for pasting into OpenSSH authorized_keys file'''. Don't worry about what that means; we're going to be emailing this to David/Rom instead.

[[Image(puttygen-6.png)]]

= Conclusion =

'''Congratulations''' You've successfully:

* Installed Git and !TortoiseGit
* Set up your !Public/Private key pair