To use SSH on your mobile device you need to download a client. There are several good quality clients available, such as Termius, Prompt 2, and Cathode.

For this tutorial we will use Termius, because it is a popular cross-platform SSH client. The process will be similar for other clients.

1. Add your Raspberry Pi as a host.

Download Termius from iTunes, if you haven’t installed it yet. Click to open the app.

A prompt asking you to allow notifications will pop up. You should click ‘Allow’ (recommended). Now follow the instruction on the screen: Start by adding a new host. Tap New Host and a new window will pop up.

Termius ‘New Host’ configuration

Enter an alias, such as ‘Raspberry Pi’. Then enter the IP address under hostname. Complete the username and password fields and hit ‘save’ in the top right corner.

If you do not know the IP address, type hostname -I in the command line on the Raspberry Pi. See here for more ways to find your IP address. The default login for Raspbian is pi with the password raspberry.

2. Connect

When you have saved the new host, you will be sent back to the ‘Hosts’ screen. There you will find the new entry. Make sure your mobile device has wireless connectivity turned on, and is connected to the same network as your Raspberry Pi.

Tap the new entry once. When the connection works, you will see a security warning. Don’t worry, everything is fine! Click ‘Continue’. You will only see this warning the first time Termius connects to a Raspberry Pi that it hasn’t seen before.

Termius ‘Security warning’

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

pi@raspberrypi ~ $

You can type exit to close the terminal window.

Termius Terminal

If a red exclamation mark appears, this indicates that something has gone wrong. Tap the exclamation mark to see the error description. ‘Connection establishment time out’ indicates that you have probably entered an incorrect IP address. If the IP address is correct, wireless connectivity on your mobile device might be turned off; the Raspberry Pi might be turned off; or the Raspberry Pi and your mobile device might be connected to different networks.

3. Modify an entry, troubleshooting, and more

A connection might be unsuccessful for various reasons. It is likely that your device or Raspberry Pi is 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.

To do so, go to the ‘Hosts’ screen, swipe left on the host you need to edit, and new functions will appear. Tap edit. A new screen titled ‘Edit Host’ will pop up.