Connecting to a Host

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

Connecting to a host requires adding one to Termius first.

Once you've added a host, double click or tap it on the Hosts screen.

Alternatively, consider the Quick-Connect option. It is useful, when you're in a hurry.

When you make a connection in Termius, that session is logged in History. It provides a log of activity and lets you easily add these past sessions as hosts.

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

Add a Host

If you're going to authenticate with a key, please, learn about Keychain first.

Adding a host entry is the first thing you'll want to do after the installation.

  1. If you're a desktop user, navigate to Hosts and click + Host.

  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 or Telnet connection, ensure that SSH / Telnet is enabled and specify the relevant parameters:

    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 remote system.

    4. (For password authentication) fill in the Password field.

    5. (For key authentication) click Keys / tap the Key field, then choose a key from the keychain, or add it right away. Consider using an identity, if you're going to use the same credentials and/or key for multiple hosts.

  4. Choose Save / .

In addition, you can choose more options.

To edit a host, double-click it and choose the relevant option.

Additional Options

Groups and Tags

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

Backspace as Ctrl + H

Enable this option for shells not recognising the Backspace key.

Environment Variables

You can pass a shell environment variable, if desired. For example:

  • LC_CTYPE as Variable.

  • UTF-8 as Value.

Startup Snippet

A snippet, i.e. a set of commands, can be run upon connection to the host.

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).

Host Chaining

Host Chaining allows you to first make a connect 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.

Proxy

If desired, you can use an HTTP or SOCKS proxy.

Socks

A SOCKS proxy is similar to a regular proxy except that it funnels more than just HTTP packets. A SOCKS proxy operates at a lower level, exchanging TCP and UDP packets between your system and a remote server. This traffic is tunneled over the SSH connection, and therefore encrypted.

Unlike a VPN, a SOCKS proxy doesn't NAT your connection to a remote network - rather it forwards packets as though programs using the network on your local machine were essentially on the remote host. A VPN assigns a new IP address, but with a SOCKS proxy, your local and public IP stays the same, but most traffic from your system appears to come from the remote host.

When configuring a host, specify the hostname and port of the SOCKS server, as well as desired username and password. The user/pass may match your SSH connection. If unsure, please consult your server administrator.

Color Schemes

Termius offers a number of colour schemes.

Choosing one for a specific host is not the only option you have:

  • You can also specify a default theme, for future hosts. You can do that in the desktop app by going to Terminal from the top left menu. In the mobile app, navigate to Settings.

  • On mobile, you can change a theme for only your current connection. Tap (iOS) or (Android) next to your connection title and choose Change Color / Choose Scheme.