Quick start

April 27, 2026 ยท View on GitHub

This webhook is directly deployed via the ExternalDNS Helm chart and runs as a sidecar. There is no separate chart for this webhook.

  1. Create a read+write API token in the Hetzner Cloud Console as described in this document.

  2. In the namespace of your ExternalDNS deployment create a secret containing your token:

# secret.yml
apiVersion: v1
kind: Secret
metadata:
  name: hetzner
stringData:
  token: <HETZNER_TOKEN>
  1. Configure the ExternalDNS values to your needs and add the webhook provider:
# values.yml
policy: sync
provider:
  name: webhook
  webhook:
    image:
      repository: docker.io/hetzner/external-dns-hetzner-webhook
      tag: v0.3.3 # x-releaser-pleaser-version
    env:
      - name: HETZNER_TOKEN
        valueFrom:
          secretKeyRef:
            name: hetzner
            key: token
  1. Add the ExternalDNS Helm repository
helm repo add external-dns https://kubernetes-sigs.github.io/external-dns/
  1. Install the Helm chart
helm upgrade --install external-dns external-dns/external-dns -f values.yml

For more details about installing ExternalDNS, see the ExternalDNS Helm chart documentation.