SSH (Secure Shell)

You can access the command line of a Raspberry Pi remotely from another computer or device on the same network using SSH.

1. Set up your client

SSH is built into Linux distributions and Mac OS. For Windows and mobile devices, third-party SSH clients are available. See the following guides for using SSH depending on the OS used by the computer or device you are connecting from:

Note that you only have access to the command line, not the full desktop environment. For the full remote desktop, see VNC.

2. Set up your local network and WiFi

Make sure your Raspberry Pi is properly set up and connected. If you're using WiFi, this is done using the wpa_supplicant.conf config file.

Otherwise, plug your Raspberry Pi directly into the router.

3. Enable SSH

As of the November 2016 release, Raspbian has the SSH server disabled by default. You will have to enable it manually. This is done using raspi-config:

Enter sudo raspi-config in the terminal, first select Interfacing options, then navigate to ssh, press Enter and select Enable or disable ssh server.

For headless setup, SSH can be enabled by placing a file named 'ssh', without any extension, onto the boot partition of the SD card.