Get started

Credentials

Connect securely to instances, automate with the CLI, and pull private images.

This page shows how to add, use and remove SSH keys, API keys and registry credentials. You manage all three on the console's Credentials page.

CredentialWhat it's for
SSH keyConnecting to instances with SSH.
API keyUsing the CLI.
Registry credentialsPulling private container images.

Add an SSH key

SSH keys let you connect to running instances with your own SSH client. Each key belongs to you, and every instance in your organization accepts the keys of all its members.

  1. Open the Credentials page and select the SSH keys tab.
  2. Click Add key.
  3. Paste your public key into Public key, for example the contents of ~/.ssh/id_ed25519.pub, and click Add key.

Create an API key

API keys let the CLI and your scripts act as you. You can create and revoke them only in the console.

  1. Open the Credentials page and select the API keys tab.
  2. Click Create key.
  3. Enter a Name, choose Scopes and an expiry under Expires, and click Create key.
  4. Copy the key.
Featherless GPU Cloud doesn't store your API key, so save it somewhere secure, such as your password manager or a CI secret. Treat your API key like a password and don't share it with anyone.

Choose scopes

ScopeReadWrite
InstancesView instances, Run Jobs, logs, metrics and network volumes.Also create, change and delete them, and open terminals.
AccountView your profile, templates, SSH keys and registry credentials.Also change them.

Write includes read. Give each script or person its own key with the narrowest scopes it needs, so you can revoke one without affecting the others.

A key acts in the organization that was active when you created it. To use another organization, switch to it in the console and create a key there.

Revoke a key

Open the key's actions menu, click Revoke key, and confirm. Anything using the key stops working immediately.

Keys belonging to instances with the CLI installed are hidden unless you switch on Show instance keys. They end when their instance stops. See Use the CLI in an instance.


Add registry credentials

Registry credentials let instances and Run Jobs pull private container images. They belong to the organization, and only owners and admins can add, change or remove them.

  1. Open the Credentials page and select the Registries tab.
  2. Click Add credentials.
  3. Enter a Name, the Registry hostname (for example ghcr.io), a Username, and a Password or access token.
  4. Click Save credentials.

Use an access token with read-only pull access where your registry supports it. When you deploy, Automatic picks a matching credential for the image's registry, or you can choose one. See Custom images.

A credential that running instances use can't be deleted, and its registry can't be changed.

Next steps

Connect to an instance

Use your SSH key, the browser terminal or the CLI.

Install the CLI

Sign in with an API key.

Custom images

Run your own image from a private registry.