Windows SSH Setup Instructions
1. Remote Log In
1.1. On Your Personal Machine, Create a Key
- Create a folder somewhere called "puttykeys".
- Download puttygen.exe and putty.exe from here.
- Open PuTTYgen.
- In the "Parameters" subsection, choose the "RSA" option (not the "SSH-1 RSA" option).
- Generate the key pair by pressing "Generate" and follow the instructions.
- Enter a secure passphrase in the "Key passphrase" fields.
- Save your public key as "csfs.pub" in your puttykeys folder.
- Save your private key as "csfs.ppk" in your puttykeys folder.
- Send an email to yourself on your Brown e-mail address with the file csfs.pub as an attachment.
1.2. Setup on Sunlab Computer
/contrib/bin/ssh-key-setup ~/Downloads/csfs.pub .
- On a sunlab computer download the file csfs.pub from your email into your home directory.
- In a Terminal, run the above ssh-key-setup command.
1.3. Set up PuTTY
On your personal computer:
- Open PuTTY
- In the "Host Name (or IP address)" box, enter "ssh.cs.brown.edu".
- In the "Connection type" subsection, make sure "SSH" is selected.
- Click on the plus sign next to "SSH" in the Category menu to expand this category. Select "Auth".
- Make sure the "Attempt keyboard-interactive auth" box is checked.
- Press the "Browse" button. Find where you saved your private key, and select it.
- Select "X11" in the "SSH" section of the Category menu. Check the "Enable X11 forwarding" box.
- Now select "Session" in the "Category" menu to return to the main screen. Type "Brown CS" in the "Saved Sessions" box, and press the "Save" button to store these settings.
1.4. Using PuTTY
- From now on, when you open PuTTY, you should see the "Brown CS" label in the "Saved Sessions" section. Double click on this label.
- PuTTY will ask you to log in. Use you CS login and the password you chose in PuTTYgen.
- You should see something like "cslab3b /u/login %". This means that you are logged into the cslab3b machine.
There are really only two big steps in using putty to log into CS Department machines. The first is key generation, and the second is setting up the Putty environment to use the correct keys and settings. All applications mentioned can be downloaded from Putty's site at:
NOTE: This information is intended for use with the CS department machines only. The desired format of the ssh keys may be different on other systems. Also, this help is meant to be brief, so if you find you need more information with very explicit step-by-step instructions and pictures, see the following:
2. X Forwarding with FastX
To run programs with GUIs written according to the X display protocol, you need an X server. The department supports the use of FastX. Follow the guide here.
3. File Transfer using WinSCP
3.1. Setting Up WinSCP
- Download and open the WinSCP installer here.
- At the "Select Components" screen, uncheck everything except "WinSCP application".
- At the "Select Additional Tasks" screen, make sure you leave "Register to handle sftp:// and scp:// addresses" checked.
- Open WinSCP.
- In the "Host name" box, type "ssh.cs.brown.edu". In the "User name" box, enter your CS login. Leave "Password" box blank. Find your private key (csfs.ppk). Make sure the File protocol subsection is SFTP, and that the "Allow SCP fallback" box is checked under the "Show advanced options" submenu.
3.2. Using WinSCP
- From now on, when you open WinSCP, you should see a "email@example.com" label in the "Stored Sessions" section. Double-click on this label.
- Enter your private key passphrase.
- A WinSCP interface should open. The left side of the screen represents your computer, the right side represents the CS filesystem. You can navigate both, and drag and drop files between them as necessary.