Getting started

Your first connection

Add a machine, sign in and accept its host key - from a fresh install to a working shell.

Add a machine

  1. Open Termphin. You see the empty machine list with No machines yet and the Add your first machine button.

    Empty machine list with No machines yetEmpty machine list with No machines yet
  2. Tap Add your first machine. The New Machine form opens.

  3. Fill in the connection details. Enter the server address in Host (for example 192.168.1.20 or server.example.com). Port defaults to 22. Username is your account on the server, such as root or admin. Name is optional - leave it blank and the host becomes the name.

    New Machine form with Connection fieldsNew Machine form with Connection fields
  4. Choose an authentication method. Under Authentication, pick Password or SSH Key.

    • Password: the account’s password on the server. It is stored encrypted on the device.
    • SSH Key: select a saved key, tap Create a new key, or Enter key manually to paste one. If the key is encrypted, fill in Passphrase. A key only works once its public half is on the server - see SSH keys explained.
    Authentication section with SSH Key selectedAuthentication section with SSH Key selected
  5. (Optional) Test the connection. Tap Test connection to verify the form works without saving. A message at the top says It works - the server let you in. or explains the failure. While testing, the button says Connecting… tap to stop.

  6. Tap Save. The machine appears in the list.

  7. Tap the machine card to connect. On the first connection to this address, you see Unknown host with the fingerprint and key type. If you can, verify the fingerprint on the server with ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub. Then tap Accept and remember.

    Unknown host prompt with fingerprint and Accept and rememberUnknown host prompt with fingerprint and Accept and remember
  8. The terminal opens. You are signed in.

    Terminal session showing shell output

Quick way: type user@host

On the empty machine list, type the address the way you would after ssh - for example [email protected] or ssh -p 2222 [email protected] - then tap the + button. The New Machine form opens with the fields filled in. Set up authentication, test or save as above.

If it does not connect

An error card shows the reason, such as wrong username or password, or the server not responding. See Troubleshooting for common fixes.

Something wrong or missing on this page?Tell us on the issue tracker.