Back to updates
New releaseSep 17, 2026

dnscontrol v5.1.0

Infrastructure as code for DNS!

Share

DNSControl

DNSControl/dnscontrol/build OpenSSF Scorecard Google Group PkgGoDev

DNSControl is Infrastructure as Code for DNS. It includes a full-featured configuration language (Javascript-compatible), plus "plug-ins" that speak to DNS provider APIs such as AWS Route 53, Cloudflare, and Gandi. It can send the same DNS records to multiple providers. It runs anywhere Go runs (Linux, macOS, Windows). The provider model is extensible, so more providers can be added.

An Example

dnsconfig.js:

D("example.com", REGISTRAR("ndc_main"), SERVICE("r53_main"),
  A("@", "1.2.3.4"),
  CNAME("www","@"),
  MX("@",5,"mail.myserver.com."),
  A("test", "5.6.7.8")
)

Running dnscontrol preview will talk to the providers (here name.com as registrar and route 53 as the dns host), and determine what changes need to be made.

Running dnscontrol push will make those changes with the provider and my dns records will be correctly updated.

The easiest way to run DNSControl is to use the Docker container:

docker run --rm -it -v "$(pwd):/dns"  ghcr.io/dnscontrol/dnscontrol preview

Getting Started

The quickest way to start is dnscontrol init. The interactive wizard asks for your DNS provider and registrar, verifies your credentials and writes a working creds.json and dnsconfig.js, including the records that already exist in your zones.

See the Getting Started page on the documentation site for the full walkthrough.

Want full "GitOps" control of your DNS data? Clone the dns-config starter repo to get started!

Supported Providers

DNSControl supports 78 DNS providers and registrars:

AdGuard HomeAkamai Edge DNSAlibaba Cloud DNSAmazon Route 53¹AutoDNS¹
AXFR + DDNSAzure DNSAzure Private DNSBunny DNSCentralNic Reseller¹
CloudflareClouDNS¹CloudPressConstellixCSC Global¹
deSECDigitalOceanDNS Made EasyDNS over HTTPS²dnscale
DNSimple¹DomainnameshopDynadot²Dynueasyname²
ExoscaleFortiGateG-Core LabsGandi v5¹Gidinet¹
GigahostGoogle Cloud DNSHetzner DNShosting.de¹Huawei Cloud DNS
Hurricane Electric DNSInfobloxInfomaniakInternet.bs²INWX¹
IONOSISC BINDJoker.comLinodeLoopia¹
LuaDNSMikroTik RouterOSMisaka.iomittwald mStudioMythic Beasts
Name.com¹Namecheap¹NetbirdnetcupNetlify
NetnodNexDNSNS1OpenproviderOpenSRS²
OpenWrtOracle Cloud InfrastructureOVHcloud¹PacketframePorkbun¹
PowerDNSRealtime Register¹RWTH AachenSakura CloudScaleway
SoftLayerSpaceship¹Tencent Cloud DNS¹TransIPUniFi
VercelVultrWebSupport

¹also supports registrar functions ²registrar only

Benefits

Categories