# Cloudflare DDNS Config

Cloudflare DDNS Config is a self-hosted network services app. A Cloudflare DDNS (Dynamic DNS) client for Docker and Unraid that keeps your A/AAAA records pointed at your current public IP. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/599/cloudflare-ddns-config

## Description

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 9 platforms: Unraid.

## Health score

79/100 (Good), based on 4 of 5 factors.
- Maintained: 99 (last commit 42 days ago)
- Popular: 73 (4,529 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 90 (no serious findings, CI)

## Links

- Official website: https://timknowsbest.com/free-dynamic-dns
- Docker Hub: https://hub.docker.com/r/timothyjmiller/cloudflare-ddns
- GitHub: https://github.com/timothymiller/cloudflare-ddns
- Unraid: https://ca.unraid.net/apps/cloudflare-ddns-config-0s2uotp0xhrmk9?q=Cloudflare-DDNS-config

## 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.

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