Changes between Version 1 and Version 2 of SourceCodeGit/Windows

Timestamp:

Jul 17, 2012, 10:03:13 AM (12 years ago)

Author:

romw

Comment:

Initial Draft

SourceCodeGit/Windows

@@ -1 @@
-This guide...
+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