# Cloudflare DDNS

Cloudflare DDNS is a configurable Docker service updating your CloudFlare DNS records periodically to match your local IP address. It is open source and self-hosted, installable on Proxmox, Kubernetes (Helm) and Unraid.

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

## Description

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, Proxmox, Helm.

## Health score

43/100 (Fair), based on 4 of 5 factors.
- Maintained: 25 (last commit 484 days ago)
- Popular: 30 (30 GitHub stars)
- Easy to install: 55 (3 install platforms, install notes, Docker image)
- Security check: 85 (no serious findings, CI)

## Links

- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=cloudflare-ddns
- Kubernetes (Helm): https://artifacthub.io/packages/helm/cloudflare/cloudflare-ddns
- Unraid: https://ca.unraid.net/apps/cloudflare-ddns-0xa3xwj1irw8vz?q=Cloudflare-DDNS

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

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