Hetzner — Key handoff
What you need
Section titled “What you need”- The Hetzner API token you copied at the end of Hetzner — Setup. If you don’t have it, go back and complete the setup guide first (the token is shown only once).
- The PhoenixVPS app, open at the Hetzner Cloud panel.
Step 1 — Paste the token into PhoenixVPS
Section titled “Step 1 — Paste the token into PhoenixVPS”In PhoenixVPS’s Hetzner Cloud panel, find Step 3 — Paste the API token. Click the box labelled “Paste Hetzner API token here…” and paste the token you copied.
(paste your Hetzner API token — a long string of letters and numbers, ~64 characters)Step 2 — Connect
Section titled “Step 2 — Connect”Click Validate & Connect.
What you see: PhoenixVPS checks the token against the Hetzner API (usually under five seconds). The Status line near the bottom of the panel updates to confirm the account is connected.
If you see an error instead, see Troubleshooting.
What happens next
Section titled “What happens next”PhoenixVPS can now create and tear down a VPN server in your dedicated Hetzner project using the token. To start a session, return to the main screen and click Connect.
Remember: a running server bills until you tear it down. Use Tear Down VPN Server when you are finished (see the FAQ), and see the Pricing page for cost details.
Troubleshooting
Section titled “Troubleshooting””Invalid token”
Section titled “”Invalid token””The token was probably truncated when copied. Hetzner shows the token only once, so if you are unsure you copied all of it, generate a fresh one: in the Hetzner Console go to your project → Security → API tokens, delete the old token, and create a new Read & Write token (see Hetzner — Setup).
The token connects but the server fails to start
Section titled “The token connects but the server fails to start”The most common cause is a Read-only token. PhoenixVPS needs Read & Write to create a server. Generate a new token with Read & Write permission and connect again.
A regional capacity limit can also cause this — check the Hetzner Console for any warnings.
Revoking access
Section titled “Revoking access”To remove PhoenixVPS’s access to your Hetzner account:
- In PhoenixVPS, click Disconnect / Revoke. This deletes the locally stored token and tears down any server the app is managing.
- To fully revoke it in Hetzner, open the Hetzner Console → your project → Security → API tokens, click the ⋯ menu next to the PhoenixVPS token, and choose Delete. (Deleting the whole dedicated project also removes the token.)
After the token is deleted, PhoenixVPS can no longer create or manage anything in your Hetzner account.