Skip to content

Demo DDNS Config

This page outlines the most common Cloudflare DNS settings used with Demo DDNS.

DNS record basics

  • Record type: A for IPv4, AAAA for IPv6.
  • Record name: specific hostname such as home.example.com.
  • TTL: 120 is a practical default for dynamic endpoints.
  • Proxy mode: start with DNS-only (proxied=false) unless you explicitly need Cloudflare proxy behavior.

Cloudflare settings checklist

  1. Confirm the zone is active in Cloudflare.
  2. Create an API token with minimum DNS edit permission for the zone.
  3. Identify the exact zone ID from Cloudflare dashboard.
  4. Ensure the target hostname record exists or is created by bootstrap logic.
  5. Validate the updater has permission to read and update DNS records.

Typical configuration block

provider: cloudflare
zone_id: "<zone-id>"
record:
  name: "home.example.com"
  type: "A"
  ttl: 120
  proxied: false
scheduler:
  interval_seconds: 300
logging:
  level: info

Configuration guidance

  • Set one updater per DNS record to avoid race conditions.
  • Use a dedicated token per app/environment pair.
  • Keep production and staging hostnames separate.
  • Document ownership for each hostname in your platform inventory.