SSH keys

Create or import SSH keys for dFlow to reach your Worker Nodes over SSH.

Written By Zoro

Last updated 3 days ago

dFlow stores SSH keys

the control plane uses when it connects to Worker Nodes (servers) over SSH for install, sync, and operations.

Where to manage keys

  1. Open your Organisation in the dashboard.
  2. Go to Security (sidebar: Security).
  3. Use the SSH Keys tab (this is the default tab; the URL may include ?tab=ssh-keys).

Creating or deleting keys requires the sshKeys permissions on your role (see Roles and permissions).

Create or import

You can:

  • Generate a key pair in dFlow (RSA 2048-bit or Ed25519).
  • Paste an existing public and private key in standard OpenSSH format.
AspectRSA (2048-bit)Ed25519 (256-bit)
Key sizeLargerCompact
SpeedSlowerFaster
SecurityWidely trustedStrong per bit
CompatibilityVery broadModern systems only

If you paste a key, confirm the public and private blocks match the algorithm you expect.

Keys are immutable

After a key is saved, its material cannot be edited. Create a new key, attach it to Worker Nodes as needed, then remove the old key.

Add a key

  1. On Security, open SSH Keys.
  2. Start Add SSH key (or equivalent).
  3. Name the key.
  4. Either generate RSA or Ed25519, or paste your pair.
  5. Save. If the UI offers download or copy, store secrets outside dFlow (password manager or your vault).

Delete a key

  1. Detach the key from every Worker Node that still references it.
  2. Delete the key from the SSH Keys list.

Related