# Hetzner DDNS

Hetzner DDNS is a lightweight Docker container that automatically updates the DNS records for your domain in the Hetzner DNS console whenever your public IP changes, keeping self-hosted services reachable behind a. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1528/hetzner-ddns

## Description

Hetzner DDNS is a lightweight Docker container that automatically updates the DNS records for your domain in the Hetzner DNS console whenever your public IP changes, keeping self-hosted services reachable behind a dynamic connection.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

47/100 (Fair), based on 4 of 5 factors.
- Maintained: 38 (last commit 350 days ago)
- Popular: 29 (28 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 100 (no serious findings, CI, tests)

## Links

- Docker Hub: https://hub.docker.com/r/kutzilla/hetzner-ddns
- GitHub: https://github.com/kutzilla/docker-hetzner-ddns
- Official website: https://www.hetzner.com
- Unraid: https://ca.unraid.net/apps/hetzner-ddns-0r08bkt0vwittl?q=hetzner-ddns

## Common questions

### Which environment variables are required to run the container?

Set ZONE_NAME to the Hetzner DNS zone, API_TOKEN to your Hetzner API token, and RECORD_TYPE to A for IPv4 or AAAA for IPv6.

### How do I update multiple DNS records?

Use the RECORD_NAME_ pattern, for example RECORD_NAME_VPN=vpn and RECORD_NAME_WEBSITE=www. The plain RECORD_NAME value is ignored when multiple records are defined.

### Can I set a different TTL for each record?

Set RECORD_NAME_<record>_TTL for each record, such as RECORD_NAME_VPN_TTL=600. If no per-record TTL is set, the default is 86400, and the generic TTL argument is ignored when per-record TTLs are used.

### How often does it check the public IP and DNS record?

It uses CRON_EXPRESSION for the update interval, defaulting to every 5 minutes.

### How do I make it start automatically after a reboot?

Run the container with --restart=always so it restarts automatically after the host reboots.

---
Source: Our Local Host (https://ourlocalhost.com/app/1528/hetzner-ddns), the self-hosted and open-source app directory.
