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

# SSH Keys

> Manage SSH access to your clusters

SSH keys are used to securely access your TensorPool clusters.

## Generating SSH Keys

If you don't already have SSH keys, generate them:

```bash theme={null}
ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519
```

This will create two files:

* `~/.ssh/id_ed25519` - Your private key (keep this secure!)
* `~/.ssh/id_ed25519.pub` - Your public key (used when creating clusters)

## Saving Your Key to Your Profile

Save your public key to your TensorPool account so it's automatically applied to every new cluster:

```bash theme={null}
tp me sshkey add ~/.ssh/id_ed25519.pub
```

Once saved, you no longer need to pass `-i` each time you create a cluster:

```bash theme={null}
# Without a saved key — must specify each time
tp cluster create 1xH100 -i ~/.ssh/id_ed25519.pub --name my-cluster

# With a saved key — just create
tp cluster create 1xH100 --name my-cluster
```

You can also manage SSH keys from the [TensorPool dashboard](https://tensorpool.dev/dashboard/ssh-keys).

Verify your saved keys at any time:

```bash theme={null}
tp me sshkey list
```

## Connecting to Clusters

Once your cluster is ready, connect using the TensorPool CLI:

```bash theme={null}
tp ssh <instance_id>
```

Your SSH client will automatically use your private key to authenticate.

## Best Practices

* **Keep your private key secure**: Never share your private key (`~/.ssh/id_ed25519`)
* **Use strong passphrases**: Protect your private key with a passphrase
* **Restrict permissions**: Ensure your private key has proper permissions (`chmod 600 ~/.ssh/id_ed25519`)

## Next Steps

* Learn about [cluster management](/features/clusters)
* See the [SSH keys guide](/guides/ssh-keys) for more details
* See the [CLI reference](/cli/account-commands#tp-me-sshkey) for all `tp me sshkey` commands