Skip to content

SSH keys and agents

Passwords work, but a key is better. Relaix takes the one you have, or makes one.

Keys are credentials

A key is a credential, like a password: made once in the Credentials panel and picked by any host or folder that signs in with it. A folder's credential is used by every host inside it. A key's passphrase is kept in the system keychain with the passwords, never in Relaix's files.

Use a key you already have

  • Import SSH keys from the .ssh folder (Credentials, or the command palette) adds the keys it finds there.
  • Or add a key credential and pick the file. OpenSSH keys work, and PuTTY's .ppk files work as they are.

Make a new key

Generate SSH key makes an Ed25519 key, the modern default, with an optional passphrase (asked twice) that encrypts it as ssh-keygen does. Then Copy public key to server on a host (its right-click menu, under Tools) adds it to the server's authorized_keys, signing in the way that host already does.

Agents

An "SSH agent" credential signs in with whatever the agent holds, so the key never leaves it: the Windows OpenSSH agent or Pageant on Windows, and the agent SSH_AUTH_SOCK names on Linux (ssh-agent, gpg-agent, GNOME Keyring, KeePassXC and others). IT can turn agents off with the AllowSshAgent policy.

Other ways in

Servers that ask questions (keyboard-interactive) and one-time codes are answered in the terminal, as with OpenSSH. Jump hosts each sign in with their own credential, and each one's host key is checked.

For Relaix 0.1 previews. Something wrong or missing here? Tell us