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]:2222into 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
.ppkwork 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_keyson 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:
- First connection: Shows the
SHA256:fingerprint for confirmation. - 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.
- 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).