SSH using Windows

On Windows you will need to download an SSH client. The most commonly used client is called PuTTY, and can be downloaded from greenend.org.uk

Look for putty.exe under the heading For Windows on Intel x86.

1. Add your Raspberry Pi as a host

PuTTY does not include an installer package: it is a stand-alone .exe file. When you run it, you will see the configuration screen below:

PuTTY configuration

Type the IP address of the Pi into the Host Name field and click the Open button. If nothing happens when you click the Open button, and you eventually see a message saying Network error: Connection timed out, it is likely that you have entered the wrong IP address for the Pi.

If you do not know the IP address, type hostname -I in the Raspberry Pi command line. There are more ways to find your IP address here.

2. Connect

When the connection works you will see the security warning shown below. You can safely ignore it, and click the 'Yes' button. You will only see this warning the first time PuTTY connects to a Raspberry Pi that it has not seen before.

PuTTY warning

You will now see the usual login prompt. Log in with the same username and password you would use on the Pi itself. The default login for Raspbian is pi with the password raspberry.

You should now have the Raspberry Pi prompt which will be identical to the one found on the Raspberry Pi itself.

pi@raspberrypi ~ $

PuTTY window

You can type exit to close the PuTTY window.

3. Modification, troubleshooting, and more

Next time you use PuTTY, look for the Saved Sessions section in the bottom half of the configuration screen. If you use this, we recommend switching to the Connection page in the left hand tree, and setting the Seconds between keepalives value to 30. Then switch back to the Session page in the tree before you click Save. Using this setting allows you to leave a PuTTY window open for long periods of time with no activity, without the Pi timing out and disconnecting you.

A connection might be unsuccessful for various reasons. It is most likely that your device or Raspberry Pi are not connected properly; SSH is disabled; there is a typo in your code; or the IP address or credentials have changed. In the latter cases, you will need to update the host. For instructions on how to update a host, and for further PuTTY documentation, please see the PuTTY docs.