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