Skip to main content

Manage your SSH Keys

Creating an SSH key

If you don't already have an SSH key, you'll need to create one. We recommend following GitHub's "Generating a new SSH key" documentation.

Uploading an SSH key

You will need to upload an SSH key in order to access a VM on Crusoe Cloud. If you are creating a VM for the first time and haven't uploaded an SSH key, you will be prompted to upload one during creation. It will be saved with the name "Default" and accessible on subsequent VM creations. You can add additional keys to be used when creating a VM here.

In order to upload an SSH key via the Crusoe Cloud console:

  • Visit the Crusoe Cloud console
  • Click the "Settings" tab in the left nav
  • Navigate to the "Tokens" section
  • Add an "Name" for your SSH key
  • Add the SSH public key (ssh-rsa... or ssh-ed25519...)
  • Click the "Add SSH Key" button

Adding keys here does not impact who can access a VM, unless that key is used to create the VM. If you are trying to grant other users access to a VM, please follow the instructions in "Add additional SSH keys to a VM."

Supported SSH key formats

Crusoe Cloud supports all SSH public key formats that are accepted by OpenSSH. These include:

For more information on the authorized key format accepted by OpenSSH, please see their docs.

Deleting an SSH key

If your SSH key has been compromised or is no longer necessary, you should delete it. Deleting an SSH key is a permanent action and cannot been undone.

In order to delete an SSH key via the Crusoe Cloud console:
  • Visit the Crusoe Cloud console
  • Click the "Settings" tab in the left nav
  • Navigate to the "SSH Keys" section
  • Navigate to the SSH key you wish to delete and click the "Trash can" icon
  • Click the "Delete" button