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

# Connect Hetzner Cloud

> This guide will help you to connect your Hetzner Cloud account to Neterial

## Generating an API token

To generate an API token on your [Cloud Console](https://console.hetzner.cloud/), please open your project and do the following:

1. Go to **Security** on the left menu bar

<img src="https://mintcdn.com/neterial-33920fed/VcVQ4N2qz5uEaAlh/cloud-providers/img/dashboard.security.en.png?fit=max&auto=format&n=VcVQ4N2qz5uEaAlh&q=85&s=0eb7abed196d031b9bb85e53946ac2f9" alt="security" width="800" height="266" data-path="cloud-providers/img/dashboard.security.en.png" />

2. Go to **API tokens** on the upper menu bar

<img src="https://mintcdn.com/neterial-33920fed/VcVQ4N2qz5uEaAlh/cloud-providers/img/api-tokens.png?fit=max&auto=format&n=VcVQ4N2qz5uEaAlh&q=85&s=7fb3cbf4efb78af2c1f21f32dee605e7" alt="API token menu" width="800" height="223" data-path="cloud-providers/img/api-tokens.png" />

3. Select **Generate API token**

<img src="https://mintcdn.com/neterial-33920fed/VcVQ4N2qz5uEaAlh/cloud-providers/img/select-generate-token.png?fit=max&auto=format&n=VcVQ4N2qz5uEaAlh&q=85&s=d3ec45be700172432afe8188aa933187" alt="generate API token" width="800" height="265" data-path="cloud-providers/img/select-generate-token.png" />

4. Create your API token

<img src="https://mintcdn.com/neterial-33920fed/VcVQ4N2qz5uEaAlh/cloud-providers/img/generate-api-token.png?fit=max&auto=format&n=VcVQ4N2qz5uEaAlh&q=85&s=8d0ea573b3aa7472ce2bca71cca54aae" alt="generate API token" width="800" height="259" data-path="cloud-providers/img/generate-api-token.png" />

* Enter a description in the upper text box.

* Choose a permission. You can choose between **Read** and **Read & Write**.

  If you select **Read**, the token will only be allowed to perform GET requests.

  If you select **Read & Write**, the token will be allowed to perform GET, DELETE, PUT and POST requests.

5. Copy your API token

<img src="https://mintcdn.com/neterial-33920fed/VcVQ4N2qz5uEaAlh/cloud-providers/img/copy-api-token.png?fit=max&auto=format&n=VcVQ4N2qz5uEaAlh&q=85&s=b562c1e1cdb6a26044b6a3dd55864fdd" alt="copy API token" width="800" height="203" data-path="cloud-providers/img/copy-api-token.png" />

You now have an API token. Note that it is not possible to view the token again once the window has been closed.

**Please note:** Your secret API token has to be included in **every request** you send to the API.

Example [curl](https://curl.se/):

```
curl \
	-H "Authorization: Bearer $API_TOKEN" \
    ...
```
