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

# Hetzner Cloud

> EU and US cloud servers — the first compute provider supported by Akua

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/akua-1dce587a/NTgnQstkErDoAPAb/images/heros/hetzner-light.svg?fit=max&auto=format&n=NTgnQstkErDoAPAb&q=85&s=de9e60b133cc161e108b2dd44846205d" alt="Two Hetzner API tokens show how Akua-managed machines use Akua's account while BYOM machines use your own account." width="1536" height="864" data-path="images/heros/hetzner-light.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/akua-1dce587a/NTgnQstkErDoAPAb/images/heros/hetzner-dark.svg?fit=max&auto=format&n=NTgnQstkErDoAPAb&q=85&s=cfb8cbd4f445c545197be8ebafb21add" alt="Two Hetzner API tokens show how Akua-managed machines use Akua's account while BYOM machines use your own account." width="1536" height="864" data-path="images/heros/hetzner-dark.svg" />
</Frame>

Hetzner Cloud is the first and default provider for Akua-managed machines today. Hetzner offers high-performance cloud servers at significantly lower prices than hyperscalers, with data centers in Europe and the United States.

## Regions

| Region      | Location           | ID     |
| ----------- | ------------------ | ------ |
| Falkenstein | Germany (Bavaria)  | `fsn1` |
| Nuremberg   | Germany (Bavaria)  | `nbg1` |
| Helsinki    | Finland            | `hel1` |
| Ashburn     | US East (Virginia) | `ash`  |
| Hillsboro   | US West (Oregon)   | `hil`  |

The default region for Akua-managed machines is **Falkenstein (fsn1)**.

## Instance types

Akua filters available instance types based on your plan. Available types in each region are verified against Hetzner's datacenter availability (not just pricing data), so the types shown are guaranteed to be provisionable.

### Free tier

| Type    | CPU    | Memory | Disk  | Architecture    | Price per hour |
| ------- | ------ | ------ | ----- | --------------- | -------------- |
| `cax11` | 2 vCPU | 4 GB   | 40 GB | ARM64           | €0.004         |
| `cx23`  | 2 vCPU | 4 GB   | 40 GB | x86             | €0.006         |
| `cpx22` | 3 vCPU | 4 GB   | 80 GB | x86 (dedicated) | €0.008         |

### Pro tier

All Hetzner Cloud server types are available, including:

| Type    | CPU    | Memory | Disk   | Architecture    | Price per hour |
| ------- | ------ | ------ | ------ | --------------- | -------------- |
| `cax21` | 4 vCPU | 8 GB   | 80 GB  | ARM64           | €0.007         |
| `cax31` | 8 vCPU | 16 GB  | 160 GB | ARM64           | €0.013         |
| `cx33`  | 4 vCPU | 8 GB   | 80 GB  | x86             | €0.011         |
| `cx43`  | 8 vCPU | 16 GB  | 160 GB | x86             | €0.021         |
| `cpx32` | 4 vCPU | 8 GB   | 160 GB | x86 (dedicated) | €0.016         |

<Info>
  ARM64 types (`cax*`) offer the best price-to-performance ratio. Use them unless your workloads require x86.
</Info>

### BYOM (bring your own cloud key)

All instance types available in your Hetzner Cloud account, with no restrictions.

## Billing model

Hetzner bills per hour, rounded up. Servers are billed as long as they exist, **even when powered off**. Akua's machine lifecycle model uses snapshots and server deletion for suspend flows rather than simply stopping the server.

| State                | Cost (cx23, 40 GB)                                  |
| -------------------- | --------------------------------------------------- |
| Running              | \~€4.11/month                                       |
| Powered off          | \~€4.11/month (Hetzner bills for the server object) |
| Suspended (snapshot) | \~€0.40/month (snapshot storage at €0.01/GB)        |
| Deleted              | €0/month                                            |

## Snapshot pricing

Hetzner charges **€0.01 per GB per month** for snapshots. Snapshots are compressed; you pay for actual used space, not total disk capacity.

| Disk size | Snapshot cost per month |
| --------- | ----------------------- |
| 40 GB     | \~€0.40                 |
| 80 GB     | \~€0.80                 |
| 160 GB    | \~€1.60                 |

## How Akua provisions machines on Hetzner

1. Akua creates a server via the Hetzner Cloud API with a cloud-init script.
2. The cloud-init script installs Kubernetes, configures the worker, and joins your cluster.
3. The machine appears in your dashboard within approximately 2 minutes.
4. Akua monitors the machine and handles its full lifecycle: scaling, suspend, and deletion.

Akua uses its own Hetzner Cloud API token for managed machines. For BYOM, your token is used instead.

## Add your own Hetzner account (BYOM)

<Steps>
  <Step title="Create an API token">
    In the [Hetzner Cloud Console](https://console.hetzner.cloud/), create an API token with **Read and Write** permissions.
  </Step>

  <Step title="Add the credential in Akua">
    Go to **Compute** in the Akua dashboard, click **Add Credential**, and paste your token. Akua validates it immediately.
  </Step>

  <Step title="Create a compute config">
    Click **Create Config**, select your credential, and choose a region.
  </Step>
</Steps>

Machines provisioned with this config appear in your Hetzner Console and bill to your account. No machine quotas or lifetime limits apply to BYOM machines.

<Info>
  Your API token is stored securely in an external secrets manager. Akua re-validates all tokens hourly and notifies you if a token becomes invalid (for example, if it was revoked or expired in the Hetzner Console).
</Info>

## Suspend and IP volatility

When you suspend a machine on Hetzner, Akua snapshots the disk and deletes the cloud server. On resume, a brand-new server is provisioned from the snapshot. This means the **public IP address changes on every resume**. Hetzner has no stop state that preserves the IP and instance.

If you need a stable public IP across suspend and resume cycles, use a floating IP, short-TTL DNS, or a load balancer in front of the machine.

## Limitations

* **No Hetzner Volume attachment on suspend and resume**: Hetzner Volumes use server IDs for attachment. If you use Hetzner CSI Volumes (not local storage or LINSTOR), additional steps may be needed on resume. Local storage and LINSTOR volumes work without issues.
* **Powered-off servers still bill**: Unlike AWS and GCP, stopping a Hetzner server does not reduce costs. Use Akua's suspend feature instead.
* **IPv6 only on some instances**: The most affordable Hetzner plans may include IPv6 only. Akua handles this through the cluster's internal networking.

## Related topics

<CardGroup cols={2}>
  <Card title="Machine lifecycle" icon="server" href="/compute/machines">
    Full machine lifecycle including provisioning, suspension, and deletion.
  </Card>

  <Card title="Compute overview" icon="cloud" href="/compute/overview">
    Akua-managed machines, BYOM keys, and manual worker paths.
  </Card>

  <Card title="Plans and pricing" icon="credit-card" href="/pricing">
    Compare plans and understand instance type access.
  </Card>
</CardGroup>
