> ## Documentation Index
> Fetch the complete documentation index at: https://runcrate.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# SSH Keys

> Add SSH keys for secure access to your GPU instances.

export const RuncrateStyles = () => {
  if (typeof document !== 'undefined' && !document.getElementById('runcrate-overrides')) {
    const s = document.createElement('style');
    s.id = 'runcrate-overrides';
    s.textContent = `
      /* Match Runcrate's rounding scale (--radius: 0.75rem) */
      .rounded-sm { border-radius: 0.5rem !important; }   /* 8px */
      .rounded-md { border-radius: 0.625rem !important; } /* 10px */
      .rounded-lg { border-radius: 0.75rem !important; }  /* 12px */
      .rounded-l-sm { border-top-left-radius: 0.5rem !important; border-bottom-left-radius: 0.5rem !important; }
      .rounded-r-sm { border-top-right-radius: 0.5rem !important; border-bottom-right-radius: 0.5rem !important; }
      .rounded-l-md { border-top-left-radius: 0.625rem !important; border-bottom-left-radius: 0.625rem !important; }
      .rounded-r-md { border-top-right-radius: 0.625rem !important; border-bottom-right-radius: 0.625rem !important; }
      .rounded-l-lg { border-top-left-radius: 0.75rem !important; border-bottom-left-radius: 0.75rem !important; }
      .rounded-r-lg { border-top-right-radius: 0.75rem !important; border-bottom-right-radius: 0.75rem !important; }

      /* Cards: never pure white in light mode */
      .card { background-color: #fcfcfc !important; border-radius: 0.75rem !important; }
      html.dark .card { background-color: #141414 !important; }

      /* Docs hero box */
      .rc-hero { background-color: #fcfcfc; border: 1px solid #e0e0e0; }
      html.dark .rc-hero { background-color: #141414; border-color: #242424; }
      html.dark .rc-hero h1 { color: #f5f5f5; }

      /* Runcrate scrollbar — thin, transparent track, hide-until-hover thumb */
      ::-webkit-scrollbar { width: 6px; height: 6px; background-color: transparent; }
      ::-webkit-scrollbar-track { background-color: transparent; }
      ::-webkit-scrollbar-thumb { background-color: rgba(155, 155, 155, 0.5); border-radius: 10px; transition: opacity 0.3s ease; opacity: 0; }
      ::-webkit-scrollbar-thumb:hover { background-color: rgba(155, 155, 155, 0.7); }
      *:hover::-webkit-scrollbar-thumb,
      *:focus::-webkit-scrollbar-thumb,
      *:active::-webkit-scrollbar-thumb { opacity: 1; }
      * { scrollbar-width: thin; scrollbar-color: rgba(155, 155, 155, 0.5) transparent; }
    `;
    document.head.appendChild(s);
  }
  return null;
};

<RuncrateStyles />

SSH keys provide secure, password-less access to your GPU instances. Add your public key to Runcrate, and it will be injected into any new instances you deploy.

## Generating a Key Pair

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

```bash theme={"theme":"github-dark"}
# Ed25519 (recommended)
ssh-keygen -t ed25519 -C "your-email@example.com"

# RSA (if Ed25519 is not supported)
ssh-keygen -t rsa -b 4096 -C "your-email@example.com"
```

This creates two files:

* **Private key** — `~/.ssh/id_ed25519` (keep this secret)
* **Public key** — `~/.ssh/id_ed25519.pub` (upload this to Runcrate)

## Copying Your Public Key

```bash theme={"theme":"github-dark"}
# macOS
pbcopy < ~/.ssh/id_ed25519.pub

# Linux
cat ~/.ssh/id_ed25519.pub | xclip -selection clipboard

# Windows (PowerShell)
Get-Content ~/.ssh/id_ed25519.pub | Set-Clipboard
```

## Adding to Runcrate

<Steps>
  <Step title="Navigate to Keys">
    Go to **Dashboard → Keys** and select the **SSH Keys** tab.
  </Step>

  <Step title="Click Add SSH Key">
    Click **Add SSH Key**.
  </Step>

  <Step title="Enter a Name">
    Give the key a recognizable name (e.g., `macbook-pro`, `work-desktop`).
  </Step>

  <Step title="Paste Your Public Key">
    Paste the contents of your `.pub` file.
  </Step>

  <Step title="Save">
    Click **Save**. The key is now available for new instance deployments.
  </Step>
</Steps>

## Managing SSH Keys

The SSH Keys tab shows all keys in the current workspace:

| Field           | Description                         |
| --------------- | ----------------------------------- |
| **Name**        | The label you gave the key          |
| **Fingerprint** | Unique identifier for the key       |
| **Type**        | Key algorithm (Ed25519, RSA, ECDSA) |

### Deleting a Key

Click **Delete** to remove an SSH key from the workspace.

<Note>
  Deleting an SSH key from Runcrate does **not** remove it from currently running instances. It only prevents the key from being added to future deployments.
</Note>

## Supported Key Types

| Type               | Recommended | Notes                                             |
| ------------------ | ----------- | ------------------------------------------------- |
| **Ed25519**        | Yes         | Modern, fast, secure. Best choice for most users. |
| **RSA** (4096-bit) | Acceptable  | Widely compatible. Use 4096 bits minimum.         |
| **ECDSA**          | Acceptable  | Good performance. Less common than Ed25519.       |

## Multiple Keys

You can add multiple SSH keys per workspace. All keys will be injected into new instances, allowing multiple team members or machines to connect.