Connecting to a Host

In short, a host is a remote computer awaiting a connection.

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

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

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

Add a Host

For key-based authentication, you need to import your key to Termius. You can do it from the Keychain screen or while adding a host (read below).

  1. If you're a desktop user, click + New host on the Hosts screen.

  2. If you're using a mobile, tap + and then New host.

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

  1. In the Label / Alias field, specify an optional name for the host entry.

  2. In the Address / Hostname field, specify the server name / IP address.

  3. For an SSH / Telnet connection, ensure that SSH / Telnet is enabled and:

    1. For an SSH / Mosh connection, enable Mosh.

    2. In the Port field, specify the port you're connecting to.

    3. In the Username field, specify the name of 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 one of the keys you’ve imported to Termius, or click + Key / tap + to import one right away (see step 2) and use it for this connection.

  4. Choose Save / .

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

Groups and Tags

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

Identities

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 be run upon connection to a host. Learn more.

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.

Color Schemes

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

Quick-Connect

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. Type in ssh you@yourserver.com -p 2222 in the bar at the top. Replace you, username and 2222 with your username, hostname and port, respectively. -p is the only supported argument at the moment. -i and other arguments are not supported.

To access this option 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.