cloudflare-ddns
π¦ Rust based dynamic DNS (DDNS) updater for Cloudflare
β 4,147 stars on GitHub Β· π΄ 407 forks Β· π License: gpl-3.0 Β· π» Language: Rust
What is cloudflare-ddns?
A standout opensource self-host project on GitHub β host on your own server for full control over your data and costs.
Main components
- π Multiple IP detection providers β Cloudflare Trace, Cloudflare DNS-over-HTTPS, ipify, local interface, custom URL, or static IPs
- π‘ IPv4 and IPv6 β Full dual-stack support with independent provider configuration
- π Multiple domains and zones β Update any number of domains across multiple Cloudflare zones
- π Wildcard domains β Support for *.example.com records
- π Internationalized domain names β Full IDN/punycode support (e.g. mΓΌnchen.de)
- π‘οΈ WAF list management β Automatically update Cloudflare WAF IP lists
- π Notifications β Shoutrrr-compatible notifications (Discord, Slack, Telegram, Gotify, Pushover, generic webhooks)
- π Heartbeat monitoring β Healthchecks.io and Uptime Kuma integration
The biggest strength is active opensource community β fast bug fixes, regular features, no abandonment risk.
Best for self-host enthusiasts wanting to try a strong-community opensource project.
Topics: the project is tagged with popular topics:
- π·οΈ
amd64 - π·οΈ
arm64 - π·οΈ
armv7 - π·οΈ
cloudflare-ddns - π·οΈ
ddns-client - π·οΈ
docker-image - π·οΈ
dynamic-dns - π·οΈ
ipv6 - π·οΈ
raspberry-pi - π·οΈ
rust
Quick install
The project ships a ready-to-use docker-compose.yml β get running in 3 commands:
git clone https://github.com/timothymiller/cloudflare-ddns.git
cd cloudflare-ddns
docker compose up -d
Minimum system requirements
| Component | Recommended |
|---|---|
| RAM | 2048 MB |
| CPU | 2 vCPU |
| Disk | 25 GB SSD |
| OS | Ubuntu 22.04 LTS / Debian 12 |
| Docker | 24.0+ |
β‘ Deploy fast on VSIS
Use the VSIS VPS Lite 2GB RAM / 2 vCPU / 25GB SSD (~104k/thΓ‘ng) plan from VSIS.NET β high-speed VN-based VPS, 24/7 support, ideal for running cloudflare-ddns smoothly.
π― Benefits:
- One-command
docker compose up -ddeploy in 2 minutes - Dedicated IPv4, root access, unmetered domestic bandwidth
- Daily snapshot backup
- Free install assistance from the VSIS team
π See matching VPS plans at vsis.net
Resources
- π GitHub: timothymiller/cloudflare-ddns
- π Homepage: https://timknowsbest.com/free-dynamic-dns
- π Official docs: see README in the repo
- π¬ Community: GitHub Issues + Discussions
Article compiled from GitHub data on 05/05/2026. Star/fork counts may have changed β see live numbers via the GitHub link.