Add a host

Save a server once and connect to it with one tap afterwards. This page goes through every field of the Add host form.

Open the form

• Tap + on the host list.
• On a computer, press Ctrl + K and choose New host.
• To change a saved host, tap its ⋮ button and choose Edit.

Fill in the form

1. Label (optional): the name shown in the list, such as Home server. Without one, the list shows user@host.

2. Group (optional): put the host in a group, such as Production or Staging. Groups fold open and closed in the list.

3. Colour tag: a coloured dot on the host's icon, so similar servers are easy to tell apart.

4. Host and Port: the server's name or IP address, and its SSH port (usually 22).

5. Username: the account you sign in as.

6. Connect via jump host: leave it on Direct connection, or pick another saved host to go through first. Use this when a server is only reachable through a gateway machine, often called a bastion. Both servers' host keys are checked separately.

7. Choose how to sign in: Password, Private key or, on a computer, OS SSH agent. See Use SSH keys for the last two.

8. Run after connect (optional): a command typed for you as soon as the shell opens, for example cd /var/www && ls.

9. Tap Save & connect, or Save changes when editing. On a computer, Ctrl + S saves too. Connect without saving tries the details once.

Advanced options

Open Advanced at the bottom of the form for options most hosts do not need.

Option	What it does
Terminal connection	SSH, the standard connection, or Mosh, which keeps the terminal alive across network changes and sleep. Mosh needs mosh-server on the host and UDP ports 60000 to 61000 open. Files and tunnels still use SSH.
Keep the shell running on the server	Runs your shell inside tmux or screen, so a reconnect returns to the same shell with whatever was running in it. Needs tmux or screen on the host.
Forward SSH agent	Lets git and ssh on the server use your keys without copying them there.
Forward X11	Shows windows of graphical programs started on the server. Linux and Windows only, and needs an X server on your device.
Allow legacy algorithms	For an old router or NAS that cannot connect otherwise. Adds weaker SHA-1 and CBC algorithms, for this host only.

WARNING

Only turn on Forward SSH agent or Forward X11 for servers you trust. While you are connected, anyone with root access on that server can use your forwarded keys, and with X11 forwarding the server may be able to see and control windows on your display.

Import from your SSH config

On Linux, Windows and macOS you can bring in hosts you already have in ~/.ssh/config. Open the ⋮ menu at the top of the host list and choose Import from ~/.ssh/config, or press Ctrl + K and choose Import from ssh config. Settings under a Match line are skipped with a note.

Manage saved hosts

Tap a host's ⋮ button for these actions:

Action	What it does
Browse files	Connects straight into the file browser.
Edit	Opens the host form.
Move to group…	Puts the host in another group.
Copy user@host	Copies the address to the clipboard.
Forget host keys	Removes the trusted host key, so the next connection asks you to verify it again.
Select	Starts picking several hosts to run a command on, or push a file to, all at once.

Deleting a host removes it and its saved password or key from this device. This cannot be undone. Nothing on the server changes. Deleting a group only moves its hosts to Ungrouped.

Next steps

• Use SSH keys
• Verify host keys
• Forward ports with tunnels