Skip to main content
SSH Keys page showing a default-keys info banner, an Add New Key button, and a table of four registered SSH keys. Keys registered here can be attached to clusters. When you attach a public key to a cluster, the cluster accepts SSH connections authenticated with the corresponding private key on your local machine.

​
Default key behavior

Acasia may apply a default SSH key to new clusters automatically. The info banner on the SSH Keys page indicates when a default key is configured for your organization. If a default key is set:
  • New clusters automatically receive that key
  • You can still attach additional keys to individual clusters

​
SSH key table fields

​
Adding an SSH key

1

Generate a key pair locally

If you do not already have an SSH key pair, generate one:
2

Copy your public key

Copy the full output — it starts with ssh-ed25519 or ssh-rsa.
3

Click Add New Key

Enter a descriptive name and paste your public key.
4

Save

The key appears in your SSH Keys table and can be attached to clusters.
Only upload public keys (the .pub file). Never upload your private key to Acasia or any other service. Your private key must remain on your local machine or in an approved secret-management system.

​
Removing an SSH key

Select Remove from the key’s Actions menu. Removing a key from Settings does not immediately revoke access to clusters it is already attached to — remove the key from the cluster directly if you need to revoke access immediately.

​
Security guidance

  • Use separate SSH keys for different machines, environments, or team members
  • Rotate SSH keys when a team member with key access leaves
  • Do not share SSH private keys — each user should have their own key pair
  • Use ed25519 keys where possible — they are more secure and faster than rsa