To connect to a host, add one, then tap or double-click it.
Alternatively, connect without adding a host using the
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:
- In the Address / Hostname field, specify the server name / IP address.
- For an SSH / Telnet connection, ensure that SSH / Telnet is enabled and:
- For a Mosh connection, enable Mosh.
- In the Port field, specify the port you're connecting to.
- In the Username field, specify the user account on the server.
- (For password authentication) fill in the Password field.
- (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.
- 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.
A snippet, i.e. a set of commands, can auto-run upon connection. Learn more about snippets.
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.
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.
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:
- Navigate to the initial screen (on the desktop) or Terminals (on mobile).
- For an SSH connection: type in
ssh email@example.com -p 2222in the bar at the top. Replace
2222with your username, hostname and port.
For a telnet connection: type in telnet
yourserver.com -p 2222in the bar at the top. Replace
2222with your hostname and port.
-pis 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 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.