Demo DDNS Overview

Demo DDNS is a reference dynamic DNS updater for Cloudflare-managed zones. It keeps a DNS record aligned with a changing public IP so home labs, edge devices, and small services remain reachable.

Purpose

• Maintain DNS continuity when ISP-assigned IP addresses change.
• Reduce manual DNS edits and outage windows.
• Provide a simple baseline integration for Dreadnought deployment patterns.

High-level architecture

1. A scheduled process runs the Demo DDNS updater.
2. The updater detects the current public IP.
3. It compares current IP vs. DNS record value in Cloudflare.
4. If values differ, it updates the record through the Cloudflare API.
5. Logs are emitted for observability and troubleshooting.

Runtime model

• Typical deployment target: Docker container in a long-running environment.
• Typical trigger: Cron-style interval (for example every 5 minutes).
• State model: stateless process; all required settings come from environment variables.

Related pages

• Install
• Config
• Troubleshooting