Skip to content

Latest commit

 

History

History
38 lines (21 loc) · 2.68 KB

windows.md

File metadata and controls

38 lines (21 loc) · 2.68 KB

SSH using Windows

On Windows you will need to download an SSH client. The most commonly used one 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 doesn't have an installer package, it's just a standalone .exe file. When you run it you'll 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's likely that you've entered the wrong IP address for the Pi.

If you don't know the IP address, just 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'll see the security warning shown below; you can safely ignore it and click the Yes button. You'll only see this warning the first time when PuTTY connects to a Pi that it has never seen before.

PuTTY warning

You'll now have 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 The next time you use PuTTY, look for the Saved Sessions section on 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 due to various reasons. It is most likely your device or Raspberry Pi are not connected properly, SSH is disabled, you might have made a typo, or the IP address or credentials might have changed. In the latter cases, you need to update the host. For instructions on how to update a host and for further PuTTY documentation please see the PuTTY docs.