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.