Most modern version control systems use SSH as a secure and convenient way to access the version control repository.
To set up SSH on Windows:
- Install putty -- the combined installer is easiest
- Add the location where putty is installed to your PATH environment variable from the Advanced tab of the System control panel.
- Run puttygen and generate an SSH2 RSA key pair. Use a passphrase you will remember. Save both private and public keys to disk. Copy the contents of the key box (starting with "ssh-rsa") to rsa-public.key on disk.
- Copy the rsa-public.key file to your server and add it to the .ssh/authorized_keys file under your username. E.g., use pscp rsa-public.key user@hostname: and then log into hostname and cat rsa-public.key >> .ssh/authorized_keys.
- Run putty and enter host name in Host Name and Saved Sessions boxes then press Save. Go to the Connection category and enter your user name on the server into the Auto-login username box. Go back to Session category and press Save again.
- Run pageant, which adds an icon to your Windows tray. Right click and select Add Key. Navigate to the private key saved from puttygen and enter your passphrase when prompted.
- Restart putty, click on the saved session, press Load, and then Open. This should open a connection to the server without prompting for any further information.
To set up SSH on Linux/Unix:
If you do not already have openssh and cvs installed, install them from packages that came with your Linux or Unix distribution.
- If ssh-add -l complains that it cannot find the SSH agent, run ssh-agent bash (or your favorite shell). This can be skipped on most modern Linux distributions because they run the X window manager inside ssh-agent.
- If you don't already have an ssh key in .ssh, issue the command ssh-keygen -t rsa to create a key pair in .ssh/id_rsa (the private key) and .ssh/id_rsa.pub (the public key). Enter a passphrase you will remember.
- Copy the file .ssh/id_rsa.pub to your server and add it to the .ssh/authorized_keys file under your username. E.g., use scp rsa-public.key user@hostname: and then log into hostname and cat rsa-public.key >> .ssh/authorized_keys.
- Back on your client (where you plan to run Wing), type ssh-add and enter your passphrase to get the SSH key loaded into ssh-agent.
- Type ssh user@hostname and you should be able to log into your server without being asked for a password.
To set up SSH on OS X:
You can set up SSH on OS X in the same way as on Linux/Unix (described above). OS X automatically manages ssh keys so you will be prompted for access to the key chain as needed by the version control system.