Getting Started

This page will help you to access the Swarthmore Computer Science network using a secure shell (SSH) application. This will allow you to run programs on the CS network, which you will need to do in order to complete assignments in many CS classes.

This page is specifically designed for students in CS21.

Your CS Account

Before you proceed, make sure that you have a password for your Swarthmore CS network account. Your username will be the same as your Swarthmore College username, but your CS network account must be activated separately. If you have not yet activated your CS network account (or you have forgotten your password), you can set your password on the SwatCS Password Service page.

Instructions for Your Operating System

This page contains instructions for Windows and MacOS users. We will use different SSH software depending upon your operating system. Please choose an appropriate link below.

Windows

We will use the PuTTY desktop application as our SSH client. Visit the PuTTY page and download the appropriate installer. For most users, the 64-bit MSI file is probably appropriate.

putty download

Modern operating systems are very touchy about installing arbitrary software for security reasons, so you’ll probably have to say it’s okay to install PuTTY.

putty installer

You should feel free to adjust the installer settings as you see fit, but the defaults are probably fine for everyone. Once you’ve clicked through the installer, you should be able to find PuTTY in your start menu. If you have trouble finding it, you can type "putty" while the start menu is open.

putty start menu

Once PuTTY launches, you’ll be greeted by a configuration menu. In the "Host Name (or IP address)" field at the top, enter cslab.cs.swarthmore.edu.

putty configure step1

Then, choose on "Data" in the lefthand column and enter your username in the "Auto-login username" field at the top. In this example, the username is "hpotter1", but you should put your own username there. Remember, your username will be the same as your Swarthmore College username.

putty configure step2

Return to the first screen by choosing "Session" on the top of the lefthand column. Then, in the "Saved Sessions" field, enter a descriptive message like "Swarthmore CS" and click the Save button.

putty configure step3

Now that we have saved this configuration, we can just double-click the "Swarthmore CS" entry in the lower box and PuTTY will open a connection to the Swarthmore CS network.

putty configure step4

The first time you connect, you will see a message asking you to confirm that you trust the computer you are accessing. You will need to click "Yes" to proceed.

putty fingerprint

Next, you will be given a black text terminal which asks you to enter your password. There will be no visual feedback that you are typing anything — this is OK! Remember, although your username for the CS network is the same as your Swarthmore College username, you may have a different password.

After entering your password, you will be greeted with a prompt.

putty logged in

You are now logged in! Any command you run here will be executed on the CS network rather than on your own computer.

If you’re not familiar with these machines, you might consider reading through the Using Unix pages that the CS department maintains. Please note, though, that you won’t be able to run any graphical programs like web browsers using this configuration. It will, however, be enough to handle all of the homework and lab assignments for CS21. Please contact your professor or lab instructor if you have any questions!

PuTTY colors

If you find the colors of your PuTTY terminal to be hard to read, learn how to change your PuTTY colors.

MacOS

MacOS comes with a terminal SSH client preinstalled. All we need to do is open the terminal and launch it! Start by finding and opening Terminal. One way to do this is by clicking on the Spotlight button (the magnifying glass in the upper right) and typing the word "Terminal".

mac spotlight

Once you’ve found the Terminal application in Spotlight, you can run it by selecting it on the left.

mac spotlight terminal

At this point, a Terminal window will open. Note the part on the left which describes your username and your computer. In the example below, the user account is named "richardw". This makes it clear that this terminal is running on the Mac.

mac terminal

In the terminal, type ssh yourusername@cslab.cs.swarthmore.edu. In this example, the username is "hpotter1", but you should put your own username there. Remember, your username will be the same as your Swarthmore College username.

The first time you run this command, you will be asked if you trust the CS network computer you’ve reached. You will need to type the word "yes" and press enter to proceed. You will only have to do this if you have never connected to the CS network before.

mac fingerprint

You will then be prompted for your CS network password. There will be no visual feedback that you are typing anything — this is OK! Remember, although your username for the CS network is the same as your Swarthmore College username, you may have a different password.

mac password

Once you enter your password, you will be greeted with a different prompt. Note that the prompt has changed to reflect the new computer you are connected to. In the example below, the computer’s name is "ibis". This is one of the CS network computers. Most of the computers you will connect to in CS21 are named after birds.

mac logged in

You are now logged in! Any command you run here will be executed on the CS network rather than on your own computer.

If you’re not familiar with these machines, you might consider reading through the Using Unix pages that the CS department maintains. Please note, though, that you won’t be able to run any graphical programs like web browsers using this configuration. It will, however, be enough to handle all of the homework and lab assignments for CS21. Please contact your professor or lab instructor if you have any questions!