octoDNS - DNS as Code

Manage DNS zones declaratively across multiple providers using octoDNS. Think of it as "infrastructure as code" but for DNS records.

⚠️ CRITICAL SAFETY WARNING

octoDNS operates on "desired state" - the YAML file represents the ENTIRE zone.

If the zone file has 1 record but DNS has 50 records, octoDNS will DELETE 49 records.

MANDATORY SAFETY WORKFLOW:

1. For existing zones: ALWAYS dump first (scripts/dump.sh)
2. ALWAYS preview before applying (run without --doit)
3. REVIEW the diff carefully - unexpected "Delete" lines = DANGER
4. Never assume - verify the preview matches your intent

Quick Start