Cloudflare DDNS Config

A Cloudflare DDNS (Dynamic DNS) client for Docker and Unraid that keeps your A/AAAA records pointed at your current public IP.

  • Network Services
  • Tools & Utilities
A Cloudflare DDNS (Dynamic DNS) client for Docker and Unraid that keeps your A/AAAA records pointed at your current public IP. It lets you reach your home network through a custom domain without a static IP, and supports a JSON config file so a single instance can update multiple zones and dozens of hosts. Written in Rust and built from scratch, it is a tiny 1.1 MB image using about 3.5 MB of RAM, and it can optionally keep Cloudflare WAF IP lists in sync. Ideal for homelabbers with a dynamic IP who manage several zones or hosts.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

74/100 Good

Maintained
100last commit 22 days ago
Popular
734,552 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
404 GB minimum RAM, runs on ARM
Security check
90no serious findings, CI

Availability: platform listings confirmed today, links checked 53 days ago

GitHub stars
4,552
Open issues
1
Last commit
2026-10-30
Latest release
v2.3.1
License
GPL-3.0
Activity
rising

Checked 20 days ago - source: GitHub (timothymiller/cloudflare-ddns)

Resources & Compatibility

Minimum requirements: 4 GB RAM, 4 CPU core(s). ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Start the EC2 web server first If you are using an EC2 origin, run `sudo yum install -y httpd` and `sudo systemctl start httpd` (`sudo` means admin rights) before configuring the ALB (the load balancer that forwards traffic) target group. This starts the web service Cloudflare will check, so your origin doesn't show unhealthy and visitors can reach your site. source
  • Preload a sample config before first run Before the first run, preload a sample config into your appdata folder so you can define your zones and hosts. In Unraid's terminal: mkdir /mnt/user/appdata/cloudflare-ddns-config and wget -qO /mnt/user/appdata/cloudflare-ddns-config/config.json https://github.com/timothymiller/cloudflare-ddns/raw/master/config-example.json, then edit the file to match your zones and hosts. If you start the contai source

Fetched 37 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Do I need host networking for IPv6 detection?

Yes, host networking is required to detect IPv6 addresses. If you only need IPv4, you can omit host networking and set IP6_PROVIDER to none.

What do I need for a basic Docker run?

Provide CLOUDFLARE_API_TOKEN and DOMAINS, then the container detects your public IP and updates the DNS records every 5 minutes.

Can one instance update multiple Cloudflare zones?

Yes. The client supports updating any number of domains across multiple Cloudflare zones.

How can I preview changes without modifying DNS?

Use dry-run mode to preview changes without modifying DNS records.

What happens if IP detection fails temporarily?

Transient IP detection failures never delete or overwrite existing DNS records.

Answers sourced from github.com

Community

Collected 44 days ago - public community threads