⚡️ Connecting to a host ⚡️ Connecting to a host

⚡️ Connecting to a host

Dmitry Machulo Dmitry Machulo

To connect to a host, add one, then tap or double-click it.

Alternatively, connect without adding a host using the ssh or telnet command.

When Termius connects to a remote server, it logs that session in History and, for ssh connections, stores details about the host including the public key and fingerprint.

You can also connect to several hosts at once.

Add a host 

If you're going to authenticate using an ssh key, you'll need to import it to Termius. It can be imported from the Keychain screen or while you're adding a host (read below).

To add a host, click + New Host or tap + on the Hosts screen.

You'll be presented with a form to fill in:

  1. In the Address / Hostname field, specify the server name / IP address.
  2. For an SSH / Telnet connection, ensure that SSH / Telnet is enabled and:
    1. For a Mosh connection, enable Mosh.
    2. In the Port field, specify the port you're connecting to.
    3. In the Username field, specify the user account on the server.
    4. (For password authentication) fill in the Password field.
    5. (For key authentication) click Keys / tap Key and choose a key from your imported keys, or click + Key / tap + to import one (see step 2) and use it for this connection.
      🗂 The Keychain screen lets you see, edit and remove imported keys.
    6. Choose Save / .

Additionally, you can use other options (see below).

Groups and tags

Groups and tags let you categorize and easily find your hosts. Learn more.


An identity consists of a user name, password, and key and is handy when you have multiple hosts with the same credentials and/or key. Learn more.

Startup snippet

A snippet, i.e. a set of commands, can auto-run upon connection. Learn more about snippets.

Agent forwarding

SSH Agent Forwarding allows your private keys to be securely accessed by remote hosts for further connection to another machine (useful in host chaining or deployments).

(Jump) Host chaining

Host Chaining allows you to first make a connection to another host before connecting to the host in question. This is useful in situations where your IP changes or for non-publicly accessible hosts. Learn more about host chaining.

Color schemes

You can specify a theme per host and choose a default theme for all new hosts. In the desktop app, you can choose a default theme by going to Terminal in Preferences. In the mobile apps, navigate to Settings.

Connect to multiple hosts

You can connect to a group of hosts or to multiple selected hosts or/and groups.

To connect to a single group, right-click it and choose Connect.

To connect to multiple hosts or/and groups, select them, right-click any selected item and click Connect.


In the Android app, tap the icon of each host / group you want to connect to, then tap and Connect.

In the iOS app, tap Select at the top right, select each host / group you want to connect to and tap n_connect_iOS_light.png


The Quick-Connect option will come in handy when you are in a hurry. It lets you connect to a host without creating a host entry.


For a quick connection:

  1. Navigate to the initial screen (on the desktop) or Terminals (on mobile).
  2. For an SSH connection: type in ssh you@yourserver.com -p 2222 in the bar at the top. Replace you, yourserver and 2222 with your username, hostname and port.
    For a telnet connection: type in telnet yourserver.com -p 2222 in the bar at the top. Replace yourserver and 2222 with your hostname and port.


  • -p is the only currently supported argument.
  • Quick telnet connections are currently supported in the mobile apps only.
  • To access Quick-Connect from the iOS home screen, force-touch the app icon.

Local host discovery

This option is available from the Terminals screen in the mobile apps.

Once you start typing, the Discover Local Hosts button appears at the bottom. Tap it to enable Bonjour (iOS) or Network Service Discovery (Android) and be presented with a list of local hosts with enabled SSH or Telnet service.

Known hosts

Known hosts is a collection of known host (public) keys.

In the desktop app, known hosts can be found in Preferences > Known Hosts. In the mobile apps, choose Known Hosts from the main menu.

⚠️ If you are prompted that a known host fingerprint has changed and you didn't reinstall the host or regenerate the host keys, you may have a security issue that needs immediate investigation.

Was this article helpful?

4 out of 14 found this helpful

Add comment

Please sign in to leave a comment.