Hetzner Module for Caddy

This package contains a DNS provider module for Caddy. It manages DNS records for the Hetzner Console using the Cloud DNS API.

Caddy Module Name

dns.providers.hetzner

Configuration

To use this module for the ACME DNS challenge, configure the ACME issuer in your Caddy JSON as follows:

{
    "module": "acme",
    "challenges": {
        "dns": {
            "provider": {
                "name": "hetzner",
                "api_token": "YOUR_HETZNER_AUTH_API_TOKEN"
            }
        }
    }
}

Or in the Caddyfile:

your.domain.com {
    respond "Hello World" # Replace with whatever config you need...
    
    tls {
        dns hetzner {env.YOUR_HETZNER_AUTH_API_TOKEN}
        propagation_delay 30s
    }
}

If you prefer to put the actual auth token directly in your config instead of an environment variable, you can replace {env.YOUR_HETZNER_AUTH_API_TOKEN} with it.

Setting propagation_delay to 30s causes Caddy to wait 30 seconds before starting the DNS TXT record propagation checks. This resolves an issue that was occurring due to slow DNS propagation (see issue #11 for details).

Authentication

For important information about credentials, see the associated README in the libdns package.