For the complete documentation index, see llms.txt. This page is also available as Markdown.

SSH Keys

Generate an SSH key pair, add it to your Nebula Block account, and use it to log into your instances.

SSH keys authenticate you to your instances. They are more secure than passwords, and Nebula Block needs one on file before it can hand you a machine you can log into. Managing them is free — add as many as you like.

Generate a key pair

If you do not already have one:

ssh-keygen -t ed25519 -C "you@example.com"

This writes a private key to ~/.ssh/id_ed25519 and a public key to ~/.ssh/id_ed25519.pub. Only the public key is uploaded to Nebula Block — never share the private half.

Add a key to your account

  1. Sign in and open SSH Keys in the console.

  2. Click to add a key, give it a name, and paste the contents of your .pub file.

  3. Save. The key is then selectable whenever you deploy an instance.

You can do the same through the API — see Create SSH Key.

cat ~/.ssh/id_ed25519.pub

Use a key

Select the key when you create an instance. Once the instance is running, connect with the matching private key:

ssh -i ~/.ssh/id_ed25519 username@instance-ip

The username and public IP are on the instance's detail page in the console.

Note: Some configurations do not support SSH keys yet. For those, a username and password are generated for you and shown on the instance detail page.

Manage keys

GET /ssh-keys/

POST /ssh-keys/

PUT /ssh-keys/{id}

DELETE /ssh-keys/{id}

Deleting a key from your account does not remove it from instances that are already running.

See also

Last updated