Overview
Recruitment
Standards
Git Setup
Git Usage
Compile

Git information is stored in a flatfile database in the “.git” folder. To interface with that database you will need a Git client. There are many different Git clients to choose from. This guide will help you setup a cygwin terminal with pubkey authentication on Windows. This is the way Cayorion does it.

PuTTY

First we are going to install cryptography software for public/private key authentication. This will help you by improving security and typing your password once, as opposed to every time you do something.

Download the PuTTY suite from http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html using the link “A Windows installer for everything except PuTTYtel”. The website looks horrible but the software is solid.

Create a public/private key pair using the following steps:

  • Launch the “PuTTYgen” application.
  • At the bottom of the window, ensure “Type of key to generate” is SSH-2 RSA.
  • At the bottom of the window, ensure “Number of bits in a generated key” is 2048.
  • Click the “Generate” button in the actions section.
  • Move your cursor around in the blank key section.
  • Set “Key comment” to your Minecraft username, such as “Cayorion”.
  • Write your password in “Key passphrase” and “Confirm passphrase”. Please use a strong password.
  • Click “Save public key”, Save as “Cayorion.public.txt” (using your own minecraft name).
  • Click “Save private key”, Save as “Cayorion.ppk” (using your own minecraft name).

Make sure to save the two files you generated in a secure location where you don’t loose them. If you know yourself to be someone who can’t keep track of their files (like MonMarty) feel free to send the files to Cayorion and he will store backups of them.

Now double click your .ppk. A window will open where you enter your password to unlock the key. On success the window will disappear. The Pageant keychain application is now running with a small minimized taskbar icon.

Do you want this password popup to appear everytime you start your computer? Add a shortcut to the .ppk in “%appdata%\Microsoft\Windows\Start Menu\Programs\Startup”.

Cygwin

Now it’s time to install the terminal and it’s applications!

Go to https://www.cygwin.com/ and download either setup-x86.exe (32-bit installation) or setup-x86_64.exe (64-bit installation). You will delete this exe later. Where you save it is not too important. Then launch it.

  • Use the “Install from Internet” option.
  • Use “C:\cygwin” as root directory.
  • Use “C:\cygwindl” as local package directory.
  • Use the “Direct Connection” option.
  • Use a download site of your choice.

Select the following packages for download:

  • git (for Git)
  • git-completion (for Git)
  • nano (suggested per default? TODO)
  • mintty (suggested per default? TODO)
  • gcc-g++ (for Charade)
  • make (for Charade)
  • keychain (for Charade)
  • openssh (for Charade)
  • psmisc (for Charade)

Charade

Compile and install Charade by following the guide at: https://github.com/wesleyd/charade
Charade will make the Cygwin terminal use the putty keychain.

If  you see the following error message when launching your terminal: “* Warning: Can’t determine fingerprint from the following line, falling back to filename”. Go to “C:\cygwin\bin” and open the file “keychain” in your text editor (such as Notepad++ or SublimeText). Modify the following section:

By changing it into this:

Configuration

Open your terminal and execute these commands. You must chose either of the first two commands depending on your OS.

Also add a bash alias “w” to quickly enter you Eclipse workspace directory. Go to “C:\cygwin\home\Yourname” and edit the file “.bashrc” adding a line similar to this one at the very end: