> For the complete documentation index, see [llms.txt](https://docs.mithril.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mithril.ai/compute-and-storage/ssh-keys.md).

# SSH keys

In order to create and access instances on Mithril, you'll first need to create or add existing SSH keys. **SSH keys in Mithril are scoped to an individual project**. See [Access management](/account-and-billing/access-management.md) for additional information on how resources are scoped in Mithril.

{% hint style="warning" %}
While it is technically possible for users within a particular Project to share SSH keys, it is best practice to keep SSH keys unique to an individual user.
{% endhint %}

## Creating SSH keys in a project

After confirming that you are in the correct project, select **SSH keys** in the left nav.

Select **Create SSH key**, and choose if you would like Mithril to generate a new key for you or if you would like to add your own. If you would like to set a key to be by default added to every new instance, select the checkbox.

{% hint style="danger" %}
If you choose to generate a key, it will automatically download upon creation. Keep this somewhere safe! You won't be able to download it again, as Mithril never retains private keys.
{% endhint %}

## Removing SSH keys from a project

To remove an SSH key from a project, open the **•••** menu next to the key you want to remove and choose **Delete**.

## Setting required SSH keys

An administrator can set an SSH key (or multiple) to be required for all new instances in a project. This can be done when creating a new key, or to existing keys with the **•••** menu. For security purposes, all keys for an instance will be shown to the user:

* **Console:** When creating a new order, the required key(s) will be pre-selected.
* **API:** When submitting a new order, the required key(s) must be included in the launch specification. Required keys can be found in the `GET ssh-keys` endpoint.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.mithril.ai/compute-and-storage/ssh-keys.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.