Skip to content

DNS-01 on Hetzner

Hetzner DNS API tokens create TXT records for ACME. Delete them after validation.

Answer first

Hetzner DNS API tokens create TXT records for ACME. Delete them after validation.

How the platform treats it

Treat the token as a secret equivalent to zone admin.

Operational checklist

Confirm the hostname or product is in the correct organization. Prefer scoped credentials. Record the audit event. Subscribe to the matching webhook. Do not enable production ACME from a guide.

Failure modes

Expect DNS propagation delay, CA rate limits, and expired tokens. The API returns stable error codes rather than HTML error pages. Retry with backoff; do not loop validate calls from a browser tab.

Related inventory

After a successful change, inspect certificates, orders, deployments and billing documents. Unexpected Certificate Transparency entries are observations, not compromise claims.

Sources and limits

This guide describes software behavior. It is not legal, tax or CA-policy advice. Provider capabilities are cited from official documentation and fact-checked in admin content. Fact-check date: 2026-09-19.