Skip to content

Hosts, Keys & Security

Adding and editing hosts

Every host entry stores a Name, Address, Port, User, and an optional Key file:

  • Quick paste: Pasting ssh [email protected]:2222 into Address automatically populates user, host, and port. IPv6 addresses work with or without brackets ([::1] or ::1).
  • Editing: Hover over a host in the sidebar and click the pencil icon.
  • Multiple sessions: Clicking an already connected host opens a second independent session (web-01 #1, web-01 #2) sharing the same accent color.

Not yet supported when importing ~/.ssh/config

Hosts using ProxyJump are skipped during import and listed in the summary dialog. Password sign-in supports standard SSH password authentication, not keyboard-interactive (2FA/OTP).

Managing SSH keys

Under Settings → Keys, Hostess lists all private keys in ~/.ssh plus any external key paths referenced by your hosts:

  • Supported formats: OpenSSH, PEM, and PuTTY .ppk work natively without conversion.
  • Generate a new key: Click Generate new key to create an ED25519 key pair (~/.ssh/<name> + .pub), optionally protected by a passphrase. Existing files are never overwritten.
  • Authorize on server: Click the copy icon on a key card and append the copied public line to ~/.ssh/authorized_keys on your server.

Storing passphrases and passwords

store.json never contains passwords or passphrases:

  • Unchecked (“Save …”): Kept in memory only until Hostess closes.
  • Checked: Stored encrypted in Windows Credential Manager tied to your Windows account:
    • A key passphrase applies to that exact key file across hosts sharing it (never to other keys).
    • A server password applies strictly to that user@address:port.
  • Forget a secret: Edit the host via the pencil icon → click Forget (deleting a host also removes its stored password automatically unless shared).

Known hosts & server verification

Hostess verifies the server's host key before transmitting any credentials:

  1. First connection: Shows the SHA256: fingerprint for confirmation.
  2. Additional key algorithms: If a server adds a new key type alongside an already trusted one, Hostess prefers the known algorithm just like OpenSSH — avoiding false alarms.
  3. Changed host key: Connection is blocked immediately with a warning dialog. Remove the old entry only when you know why the server key changed (e.g., OS reinstall).