Skip to content
Reoclo Docs

Hetzner Setup

The Hetzner integration lets you manage cloud servers directly from Reoclo. Once connected, you can discover existing servers, perform power operations, view CPU and network metrics, and access rescue mode and VNC console.

Prerequisites

Section titled “Prerequisites”
  • A Hetzner Cloud account with at least one project
  • A server in the project you want to manage
  • A Reoclo account with server management access

Step 1: Generate an API Token

Section titled “Step 1: Generate an API Token”
  1. Log into the Hetzner Cloud Console
  2. Select the project containing your servers
  3. Navigate to Security > API Tokens
  4. Click Generate API Token
  5. Enter a description (for example, reoclo-integration)
  6. Select Read & Write permissions
  7. Click Generate API Token and copy the token

Step 2: Add the Credential in Reoclo

Section titled “Step 2: Add the Credential in Reoclo”
  1. In Reoclo, navigate to Cloud Providers in the sidebar
  2. Click Add Provider
  3. Select Hetzner Cloud from the dropdown
  4. Enter a label (for example, my-hetzner-prod)
  5. Paste the API token
  6. Click Test & Save to verify the credential

Reoclo will make a lightweight API call to confirm the token is valid and has access to the project.

Section titled “Step 3: Discover and Link Servers”

After adding the credential, you can discover servers from your Hetzner project:

  1. Click Discover Instances on the credential detail page
  2. Reoclo scans your Hetzner project and lists all servers
  3. For each server, you will see the name, status, IP addresses, specs, and region
  4. Click Link to connect a discovered server to Reoclo
  5. If the server already exists in Reoclo (matched by IP), it will be linked automatically

You can also link servers manually from the server edit page by entering the Hetzner server ID.

Features

Section titled “Features”

Power Operations

Section titled “Power Operations”

From the server detail page, you can:

  • Power On a stopped server
  • Shutdown (graceful OS-level shutdown)
  • Reboot the server
  • Hard Reset (immediate reboot without OS shutdown)
  • Power Off (hard power-off)

Operations are tracked in real time with progress indicators. Hetzner provides progress percentages for most actions.

Rescue Mode

Section titled “Rescue Mode”

Rescue mode boots your server into a temporary Linux environment, which is useful for recovering from broken configurations or reinstalling the OS.

  1. Navigate to the server detail page
  2. Click Rescue Mode in the power operations menu
  3. The server reboots into the Hetzner rescue system
  4. Connect via SSH using the provided credentials

VNC Console

Section titled “VNC Console”

For direct graphical access, you can request a VNC console session:

  1. Navigate to the server detail page
  2. Click Console to open a VNC session
  3. Use the provided WebSocket URL and password to connect

Metrics

Section titled “Metrics”

Reoclo pulls CPU, disk, and network metrics from the Hetzner API automatically. These are displayed on the server detail page alongside any metrics from the Runner agent.

Instance Sync

Section titled “Instance Sync”

Server metadata (status, IPs, specs, region) is synced periodically from the Hetzner API. You can also trigger a manual sync from the server detail page.

Troubleshooting

Section titled “Troubleshooting”

Credential verification fails

Section titled “Credential verification fails”
  • Confirm the token was copied completely (no trailing spaces)
  • Check that the token has Read & Write permissions (read-only tokens cannot perform power operations)
  • Verify the token has not been revoked in the Hetzner Cloud Console

Discovery returns no servers

Section titled “Discovery returns no servers”
  • Confirm the API token belongs to the correct Hetzner project
  • Check that the project has at least one active server
  • Tokens are project-scoped, so servers in other projects will not appear

Power operations are slow

Section titled “Power operations are slow”

Hetzner actions are asynchronous. Most operations complete within 30 seconds, but some (like rescue mode) can take up to a few minutes. The progress indicator will update automatically.

Next Steps

Section titled “Next Steps”