Skip to main content

​
Before you begin

  • You have an SSH key pair on your local machine.
  • You have access to the cluster in the Developer Portal.
Upload only the public part of your SSH key (for example, id_ed25519.pub). Private keys must never leave your machine or your approved secret-management system.

​
Walkthrough

1

Confirm the cluster is Active

On the Clusters page, the status badge should read Active. Provisioning clusters do not accept SSH yet.
2

Confirm your public SSH key is attached

Open the cluster, go to SSH keys, and verify your public key is listed.
3

Copy the SSH command

Use the Copy command button on the cluster connection panel.
4

Connect from your terminal

Run the command in a local terminal.
5

Verify the connection

You should land in the cluster’s shell. Run nvidia-smi to confirm GPU access.
The first time you connect, your terminal may ask whether you trust the host fingerprint. Confirm only if the host or IP matches the cluster connection details shown in Acasia.

​
Troubleshooting permission denied

  • Confirm the public key was uploaded, not the private key
  • Confirm the cluster is Active
  • Confirm the username matches the connection panel
  • Confirm a matching private key exists locally
  • Confirm file permissions on ~/.ssh