Skip to content

SSH keys ​

A Secure Shell (SSH) key logs you in to your servers without a password. You keep the private key and we install the public key. Manage them under Security in the sidebar, then SSH Keys.

Keys belong to the workspace, so one upload covers every server you create in it. Each key in the list shows its name, who uploaded it, and its fingerprint.

The SSH Keys page with the Upload SSH Key button.
Upload SSH Key on the SSH Keys page.

If you do not have a key, the getting-started guide has an in-browser generator that never uploads the private key. Generate an SSH key.

Existing servers ​

An uploaded key is trusted on new servers. For an existing server, open the instance, then Advanced, then Sync SSH Keys. The server must be from one of our templates, and it reboots.

Sync replaces the keys on the server

The root or admin authorized_keys file is overwritten with your workspace keys. Keys you added by hand are removed.

When a device is retired or someone leaves, remove the key here and sync the remaining keys to the servers that trusted it.