Cloudflare DDNS

Cloudflare DDNS is a configurable Docker service updating your CloudFlare DNS records periodically to match your local IP address.

  • Network Services
  • Other
  • Productivity
  • Tools & Utilities
Cloudflare DDNS is a configurable Docker service updating your CloudFlare DNS records periodically to match your local IP address.

Platform availability

Available on 3 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox
  • Helm
  • 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.

43/100 Fair

Maintained
25last commit 484 days ago
Popular
3030 GitHub stars
Easy to install
553 install platforms, install notes, Docker image
Light to run
No data
Security check
85no serious findings, CI

Based on 4 of 5 factors.

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

GitHub stars
30
Open issues
3
Last commit
2025-07-25
License
MIT
Activity
stale

Checked 7 days ago - source: GitHub (Akarys42/cloudflare-ddns-docker)

Resources & Compatibility

Requirements not published yet.

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

First-install notes

  • Add your Cloudflare login details Set an API token, or an API key plus your Cloudflare account email, in the app's settings. If these are blank or wrong, the app cannot log in to Cloudflare or update your DNS records (the names that point to your server's IP). source
  • If using an API key, add email When you use an API key instead of a token, the account email is required for the connection. Without it, Cloudflare won't know which account to connect to. source
  • Read Cloudflare error messages If Cloudflare rejects a DNS change, the error includes its message and details. Look at the error, because it usually points to bad credentials or an invalid request. source

Fetched 47 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

What Cloudflare token scopes are required for Cloudflare DDNS?

You need a user API token with Zone:Read and DNS:Edit scopes.

How do I choose which domains and DNS record types are updated?

Pass the domains as command-line arguments after the options or set them in CF_DDNS_DOMAINS as a space-separated list. You can prefix a domain with A or AAAA followed by a colon; otherwise any found A or AAAA record pointing to that domain is used.

Can I run Cloudflare DDNS on the host instead of Docker?

Yes. You need Python greater than 3.8 plus the listed dependencies, and you can launch it with the cloudflare_ddns module, usually using python -m cloudflare_ddns.

Where can I get the prebuilt Docker image?

It is available on the GitHub Container Registry, and you can also build the container yourself from the repository.

Answers sourced from github.com

Community

Collected 49 days ago - public community threads