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 does the heavy lifting. It talks to the remote repository, tracks your local changes, and so forth. It's the first piece of the puzzle.

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