Skip to main content
The ssh-key command (alias: ssh-keys) lets you manage the SSH public keys associated with your VESSL Cloud account. Keys are referenced by slug (unique identifier) — pass that slug to vesslctl workspace create --ssh-key to attach a key when launching a workspace.

​
list

List all SSH keys registered to your account.
The output shows each key’s slug, name, fingerprint, and creation time. Copy the slug to use with other commands.

​
add

Register a new SSH public key. You can either upload an existing public key file or have VESSL generate a new keypair on the server.
Example — upload an existing public key:
Example — generate a new keypair on the server:
The command prints the slug of the newly registered key. Use that slug with vesslctl workspace create --ssh-key <ssh-key-slug>.
The --generate option prints the private key to your terminal exactly once and does not store it on the server. Save the output to a file (for example, ~/.ssh/<key-name>) and chmod 600 it before closing the session, or you will lose access to the key.

​
delete

Delete an SSH key by slug.
Example:
Deleting a key only removes it from your VESSL Cloud account. Workspaces that already had the key attached at creation continue to accept it until they are terminated.