DNSControl
DNSControl is an opinionated platform for seamlessly managing your DNS configuration across any number of DNS hosts, both in the cloud or in your own infrastructure. It manages all of the domains for the Stack Overflow network, and can do the same for you!
Try It
Want to jump right in? Follow our quick start tutorial on a new domain or migrate an existing one. Read the language spec for more info. You can also view a list of all topics.
Use It
Take advantage of the advanced features. Use macros and variables for easier updates. Upload your zones to multiple DNS providers.
Get Involved
Join our mailing list. We make it easy to contribute by using GitHub, you can make code changes with confidence thanks to extensive integration tests. The project is newbie-friendly so jump right in!
Features
Maintain your DNS data as a high-level DS, with macros, and variables for easier updates.
Super extensible! Plug-in architecture makes adding new DNS providers and Registrars easy!
Eliminate vendor lock-in. Switch DNS providers easily, any time, with full fidelity.
Reduce points of failure: Easily maintain dual DNS providers and easily drop one that is down.
Supports 35+ DNS Providers including BIND, AWS Route 53, Google DNS, and name.com
Apply CI/CD principles to DNS: Unit-tests, system-tests, automated deployment.
All the benefits of Git (or any VCS) for your DNS zone data. View history. Accept PRs.
Optimize DNS with SPF optimizer. Detect too many lookups. Flatten includes.
Runs on Linux, Windows, Mac, or any operating system supported by Go.
Enable/disable Cloudflare proxying (the "orange cloud" button) directly from your DNSControl files.
Assign an IP address to a constant and use the variable name throughout the configuration. Need to change the IP address globally? Just change the variable and "recompile."
Keep similar domains in sync with transforms, macros, and variables.
Getting Started
Information for new users and the curious.
- Getting Started: A walk-through of the basics
- Providers: Which DNS providers are supported
- Examples: The DNSControl language by example
- Migrating: Migrating zones to DNSControl
- TypeScript (optional): Improve autocomplete and add type checking
Commands
DNSControl sub-commands and options.
- creds.json: creds.json file format
- check-creds: Verify credentials
- get-zones: Query a provider for zone info
- get-certs: Renew SSL/TLS certs (DEPRECATED)
Reference
Language resources and procedures.
- Language Reference: Description of the DNSControl language (DSL)
- Aliases: ALIAS/ANAME records
- SPF Optimizer: Optimize your SPF records
- CAA Builder: Build CAA records the easy way
Advanced features
Take advantage of DNSControl's unique features.
- Why CNAME/MX/NS targets require a trailing "dot"
- Testing: Unit Testing for you DNS Data
- Notifications: Web-hook for changes
- Code Tricks: Safely use macros and loops.
- CLI variables: Passing variables from CLI to JS
- Nameservers & Delegation: Many examples.
- Gitlab CI/CD example.
Developer Info
It is easy to add features and new providers to DNSControl. The code is very modular and easy to modify. There are extensive integration tests that make it easy to boldly make changes with confidence that you'll know if anything is broken. Our mailing list is friendly. Afraid to make your first PR? We'll gladly mentor you through the process. Many major code contributions have come from first-time Go users!
- GitHub StackExchange/dnscontrol: Get the source!
- Mailing list: dnscontrol-discuss: The friendly best place to ask questions and propose new features
- Bug Triage: How bugs are triaged
- Release Engineering: How to build and ship a release
- Bring-Your-Own-Secrets: Automate tests
- Step-by-Step Guide: Writing Providers: How to write a DNS or Registrar Provider
- Step-by-Step Guide: Adding new DNS rtypes: How to add a new DNS record type
- DNS reordering: How DNSControl determines the order of the changes
Icons made by Freepik from www.flaticon.com