v4.33.1

Greetings DNS fans!

Summary: This is a bugfix release (and 2 small additions came along for the ride). If you use the new Cloudflare comments and tags feature, you can now remove those comments and tags too!

Thanks to all contributors involved in this release! This is a community project and we couldn't do it without all of your contributions!

Sincerely,
--Tom Limoncelli

Monthly video call!

Everyone is invited to the Monthly DNSControl Community Video Conference Call on the 2nd Tuesday of each month. Join whether you are a new user with questions or an experienced developer that wants to discuss DNSControl internals... or anything in between! Meeting details on
GitHub Discussions.

Changelog

Provider-specific changes:

• ec5e9b7: CLOUDFLAREAPI: Fix comment and tag removal not taking effect (#4045) (@allixsenos)
• dfb1ed5: LINODE: Enable Service (SRV) record support (#4048) (@grahammiln)

Dependencies:

• fe8fcf4: CHORE: Update deps (#4047) (@tlimoncelli)

Deprecation warnings

Warning

• REV() will switch from RFC2317 to RFC4183 in v5.0. This is a breaking change. Warnings are output if your configuration is affected. No date has been announced for v5.0. See https://docs.dnscontrol.org/language-reference/top-level-functions/revcompat
• NAMEDOTCOM, OPENSRS and SOFTLAYER need maintainers! These providers have no maintainer. Maintainers respond to PRs and fix bugs in a timely manner, and try to stay on top of protocol changes.

Install

macOS and Linux

Install with Homebrew (recommended)

brew install dnscontrol

Using with Docker

You can use the Docker image from Docker hub or GitHub Container Registry.

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

Anywhere else

Alternatively, you can install the latest binary (or the apt/rpm/deb/archlinux package) from this page.

Or, if you have Go installed, you can install the latest version of DNSControl with the following command:

go install github.com/StackExchange/dnscontrol/v4@main

Update

Update to the latest version depends on how you choose to install dnscontrol on your machine.

Update with Homebrew

brew upgrade dnscontrol

Alternatively, you can grab the latest binary (or the apt/rpm/deb package) from this page.

v4.33.0

Greetings DNS fans!

WARNING: This release overhauled two internal systems. There should be no user-visible affects. However... please test carefully before putting it into production. What changed? (1) how DS records are managed (this doesn't affect many users), and (2) how IP addresses are managed (this affects everyone).

Highlights:

• 2 new providers! GIDINET and INFOMANIAK! Grazie to @zupolgec for contributing Gidinet (both DNS provider and registrar) (#4004), and thanks to @jbelien for adding INFOMANIAK (also both DNS provider and registrar) (#3574)
• 2 big refactoring projects: DS was rewritten to use the more modern RecordConfigV2 (#3996) and we converted net.IP to the more modern netip.Addr (#4012)
• Cloudflare gained support for record comments, tags, and CNAME flattening thanks to @allixsenos
• DESEC gained support for LOC record (#4011) thanks to @androw
• DIGITALOCEAN doccs have been updated (#4029) thanks to @chicks-net (he also contributed #4041 which fixed many broken links)
• JOKER now correctly updates TTLs on CAA and other records #4019 thanks to @grahammiln
• And many other improvements!

Thanks to all contributors involved in this release! This is a community project and we couldn't do it without all of your contributions!

Sincerely,
--Tom Limoncelli

Monthly video call!

Everyone is invited to the Monthly DNSControl Community Video Conference Call on the 2nd Tuesday of each month. Join whether you are a new user with questions or an experienced developer that wants to discuss DNSControl internals... or anything in between! Meeting details on GitHub Discussions.

Changelog

Major features:

• fa57bf0: NEW PROVIDER: Gidinet DNS provider and registrar (#4004) (@zupolgec)
• 776b666: NEW PROVIDER: INFOMANIAK (#3574) (@jbelien)
• 906495a: REFACTOR: Rewrite DS to use RecordConfigV2 (#3996) (@tlimoncelli)
• e999c7f: REFACTOR: Convert net.IP to netip.Addr (#4012) (@tlimoncelli)

Provider-specific changes:

• d0a0a02: CLOUDFLAREAPI: Add per-record CNAME flattening support (#4020) (@allixsenos)
• 5ae29a6: CLOUDFLAREAPI: Add support for record comments and tags (#4025) (@allixsenos)
• 5400286: CLOUDFLAREAPI: Reduce confusion by making CF_CNAME_FLATTEN_ON and CF_PROXY_ON mutually exclusive (#4026) (@allixsenos)
• 39be60d: DESEC: add support for LOC record (#4011) (@androw)
• 5021e61: DIGITALOCEAN: self-documenting Cannot()s for unsupported features (#4029) (@chicks-net)
• 2bb352f: JOKER: TTLs may not always be set for CAA and other records (#4019) (@grahammiln)

Documentation:

• f792c87: DOCS: Fix DKIM_BUILDER instruction typo ("note" not "notes") (#4027) (@flindeberg)
• e5e7934: DOCS: debug provider links that had underscores before 3909 (#4041) (@chicks-net)

CI/CD:

• cef3402: Build(deps): Bump alpine from 3.23.2 to 3.23.3 (#4032) (@dependabot[bot])
• 0d0ee28: CICD: Enable testing of cloudflare redirects (#4022) (@tlimoncelli)

Dependencies:

• 26cb204: CHORE: Upgrade dependencies (#4037) (@tlimoncelli)

Other changes and improvements:

• e01b174: FEATURE: Output memory statistics (--full) (#4031) (@tlimoncelli)
• b346a4c: BUGFIX: avoid collisions in context with custom type (staticcheck/SA1029) (#4014) (@grahammiln)
• 59f4da4: BUGFIX: avoid impossible comparison (staticcheck/SA4003) (#4015) (@grahammiln)
• 0e5fbef: BUGFIX: error contains advice for presentation (staticcheck/ST1005) (#4016) (@grahammiln)
• 375b150: CHORE: generate-all.sh (#4043) (@tlimoncelli)
• 566df5e: REFACTOR: Label legacy miekg/dns package as dnsv1 (#4024) (@tlimoncelli)
• a91c54b: REFACTOR: use idiomatic Go (staticcheck/S1002+S1009) (#4017) (@grahammiln)

Deprecation warnings

Warning

• REV() will switch from RFC2317 to RFC4183 in v5.0. This is a breaking change. Warnings are output if your configuration is affected. No date has been announced for v5.0. See https://docs.dnscontrol.org/language-reference/top-level-functions/revcompat
• NAMEDOTCOM, OPENSRS and SOFTLAYER need maintainers! These providers have no maintainer. Maintainers respond to PRs and fix bugs in a timely manner, and try to stay on top of protocol changes.

Install

macOS and Linux

Install with Homebrew (recommended)

brew install dnscontrol

Using with Docker

You can use the Docker image from Docker hub or GitHub Container Registry.

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

Anywhere else

Alternatively, you can install the latest binary (or the apt/rpm/deb/archlinux package) from this page.

Or, if you have Go installed, you can install the latest version of DNSControl with the following command:

go install github.com/StackExchange/dnscontrol/v4@main

Update

Update to the latest version depends on how you choose to install dnscontrol on your machine.

Update with Homebrew

brew upgrade dnscontrol

Alternatively, you can grab the latest binary (or the apt/rpm/deb package) from this page.

v4.33.0-beta1 (Please test if you use DS records!)

Greetings DNS fans!

This is a pre-release. If you use DS records, please test this extensively.

The DS record type has been rewritten to use the new RecordConfigv2 struct. It should be entirely backwards compatible with older providers. However, to be extra cautious, I'm releasing this as a pre-release.

It currently passes all integration tests on the platforms I have access to.

• Test with providers not listed here: https://github.com/StackExchange/dnscontrol/actions/runs/21334415887
• Please test in your environment (with caution!). Please use preview first. Try deleting, creating, and modifying DS records.

This is on a tight schedule. If I don't hear of any show-stopper bugs, it will be merged on Monday, Feb 2, 2026.

Thanks!

--Tom Limoncelli

Changelog

Other changes and improvements:

• 906495a: REFACTOR: Rewrite DS to use RecordConfigV2 (#3996) (@tlimoncelli)

Install

macOS and Linux

Install with Homebrew (recommended)

brew install dnscontrol

Using with Docker

You can use the Docker image from Docker hub or GitHub Container Registry.

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

Anywhere else

Alternatively, you can install the latest binary (or the apt/rpm/deb/archlinux package) from this page.

Or, if you have Go installed, you can install the latest version of DNSControl with the following command:

go install github.com/StackExchange/dnscontrol/v4@main

Update

Update to the latest version depends on how you choose to install dnscontrol on your machine.

Update with Homebrew

brew upgrade dnscontrol

Alternatively, you can grab the latest binary (or the apt/rpm/deb package) from this page.

v4.32.0

Greetings DNS fans!

Highlights:

• 9e73e73: BunnyDNS users will be happy to learn that DNSControl has been updated to allow SRV "." targets, which BunnyDNS only recently started supporting (#4003)
• ae9759d: Cloudflare users will be happy to know that the warnings the CF Dashboard displays about TXT records are a thing of the past... at least for TXT records created and or updated starting with this version (#3834) (@tlimoncelli)
• Many documentation improvements, including links to RFCs (#3970 thanks to @grahammiln!) and info on how to use VSCode and the Go Debugger (#3998)
• Internal improvements continue on the RecordConfigv2 project. Legacy providers (which is all of them, currently) are better supported.

Thanks to all contributors involved in this release! This is a community project and we couldn't do it without all of your contributions!

Sincerely,
--Tom Limoncelli

Monthly video call!

Everyone is invited to the Monthly DNSControl Community Video Conference Call on the 2nd Tuesday of each month. Join whether you are a new user with questions or an experienced developer that wants to discuss DNSControl internals... or anything in between! Meeting details on
GitHub Discussions.

Changelog

Provider-specific changes:

• 8a8d289: BIND: Future-proof BIND so it works work RecordConfigv2 better (#4002) (@tlimoncelli)
• 9e73e73: BUNNYDNS: Permit SRV "." targets (#4003) (@tlimoncelli)
• ae9759d: CLOUDFLAREAPI: Prevent web UI from displaying warnings about TXT records (#3834) (@tlimoncelli)

Documentation:

• fd75c58: DOCS: Expanded acronyms and added RFC links. (#3970) (@grahammiln)
• 081fb72: DOCS: Release process needs tip on how to find latest version (#4007) (@tlimoncelli)
• 29d8f36: DOCS: Update VSCode debugging instructions for itests and cmd (#3998) (@tlimoncelli)

Dependencies:

• c8c7cd5: CHORE: Update dependencies (#4006) (@tlimoncelli)

Other changes and improvements:

• c529d9d: BUGFIX: RecordConfigv2 should fix records from legacy providers (#4001) (@tlimoncelli)
• 5be6467: CHORE: Use modernize -fix to update code (#4005) (@tlimoncelli)
• 16ee9d1: CHORE: generate-all.sh (#4008) (@tlimoncelli)
• 79d42a6: REFACTOR: Move model.RRtoRC* to its own package dnsrr (#3999) (@tlimoncelli)
• dee2b04: REFACTOR: PaveArgs flags should be b/w/s for 8, 16, string (#4000) (@tlimoncelli)

Deprecation warnings

Warning

• REV() will switch from RFC2317 to RFC4183 in v5.0. This is a breaking change. Warnings are output if your configuration is affected. No date has been announced for v5.0. See https://docs.dnscontrol.org/language-reference/top-level-functions/revcompat
• NAMEDOTCOM, OPENSRS and SOFTLAYER need maintainers! These providers have no maintainer. Maintainers respond to PRs and fix bugs in a timely manner, and try to stay on top of protocol changes.

Install

macOS and Linux

Install with Homebrew (recommended)

brew install dnscontrol

Using with Docker

You can use the Docker image from Docker hub or GitHub Container Registry.

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

Anywhere else

Alternatively, you can install the latest binary (or the apt/rpm/deb/archlinux package) from this page.

Or, if you have Go installed, you can install the latest version of DNSControl with the following command:

go install github.com/StackExchange/dnscontrol/v4@main

Update

Update to the latest version depends on how you choose to install dnscontrol on your machine.

Update with Homebrew

brew upgrade dnscontrol

Alternatively, you can grab the latest binary (or the apt/rpm/deb package) from this page.

v4.31.1

Greetings DNS fans!

If you use the SPF optimizer, do NOT use v4.31.0. This release fixes the regression.

Version 4.31.0 introduced a bug in the SPF optimizer. Eagle-eyed @sourgrasses found and fixed the problem! Thanks!

Sincerely,
--Tom Limoncelli

Monthly video call!

Everyone is invited to the Monthly DNSControl Community Video Conference Call on the 2nd Tuesday of each month. Join whether you are a new user with questions or an experienced developer that wants to discuss DNSControl internals... or anything in between! Meeting details on
GitHub Discussions.

Changelog

Bug fixes:

• 8470260: BUGFIX: fix regression on a mechanism parts (#3994) (@sourgrasses)

CI/CD:

• c421cdc: Build(deps): Bump actions/cache from 5.0.1 to 5.0.2 (#3989) (@dependabot[bot])
• 32f3d3e: CHORE: Update Monthly video meeting info (#3993) (@tlimoncelli)

Deprecation warnings

Warning

• REV() will switch from RFC2317 to RFC4183 in v5.0. This is a breaking change. Warnings are output if your configuration is affected. No date has been announced for v5.0. See https://docs.dnscontrol.org/language-reference/top-level-functions/revcompat
• NAMEDOTCOM, OPENSRS and SOFTLAYER need maintainers! These providers have no maintainer. Maintainers respond to PRs and fix bugs in a timely manner, and try to stay on top of protocol changes.

Install

macOS and Linux

Install with Homebrew (recommended)

brew install dnscontrol

Using with Docker

You can use the Docker image from Docker hub or GitHub Container Registry.

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

Anywhere else

Alternatively, you can install the latest binary (or the apt/rpm/deb/archlinux package) from this page.

Or, if you have Go installed, you can install the latest version of DNSControl with the following command:

go install github.com/StackExchange/dnscontrol/v4@main

Update

Update to the latest version depends on how you choose to install dnscontrol on your machine.

Update with Homebrew

brew upgrade dnscontrol

Alternatively, you can grab the latest binary (or the apt/rpm/deb package) from this page.

v4.31.0

Greetings DNS fans!

Thanks to all contributors involved in this release! This is a community project and we couldn't do it without all of your contributions!

Highlights:

• NEW PROVIDER! Welcome "DNSCALE" (https://www.dnscale.eu/) to the DNSControl family!
• BUNNYDNS now supports SVCB and HTTPS
• CLOUDNS has many bugfixes and improvements, and "create-zones" now works!
• ...and much, much, more!

Sincerely,
--Tom Limoncelli

Monthly video call!

Everyone is invited to the Monthly DNSControl Community Video Conference Call on the 2nd Tuesday of each month. Join whether you are a new user with questions or an experienced developer that wants to discuss DNSControl internals... or anything in between! Meeting details on
GitHub Discussions.

Changelog

Provider-specific changes:

• 23a4b31: BIND: add missing implementation for ZoneCreator (#3980) (@fritterhoff)
• bd40291: BUNNYDNS: Add SVCB and HTTPS support (#3937) (@jeda)
• 8661346: CLOUDNS: fix format string for nameserver diff (#3975) (@RobinDaugherty)
• a5aee59: CLOUDNS: fix zone auto-creation (#3976) (@RobinDaugherty)
• 2b7fa28: CNR: prevent duplicate nameservers in registrar corrections to fix #3985 (#3987) (@AsifNawaz-cnic)
• fc8a508: DIGITALOCEAN: Disable SOA support (#3979) (@chicks-net)

Documentation:

• 251f2af: DOCS: Fix incorrect hetzner links (#3988) (@willpower232)
• eba26fd: DOCS: add DNScale (#3984) (@dnscale-ops)

Dependencies:

• 37e7c1f: CHORE: Update deps and re-run generate.sh (#3990) (@tlimoncelli)

Other changes and improvements:

• 72cbf39: DNSCALE: Add DNScale DNS provider (#3973) (@dnscale-ops)
• 819253a: fix(spf): Be case-insensitive when parsing SPF records (#3982) (@tlimoncelli)

Deprecation warnings

Warning

• REV() will switch from RFC2317 to RFC4183 in v5.0. This is a breaking change. Warnings are output if your configuration is affected. No date has been announced for v5.0. See https://docs.dnscontrol.org/language-reference/top-level-functions/revcompat
• NAMEDOTCOM, OPENSRS and SOFTLAYER need maintainers! These providers have no maintainer. Maintainers respond to PRs and fix bugs in a timely manner, and try to stay on top of protocol changes.

Install

macOS and Linux

Install with Homebrew (recommended)

brew install dnscontrol

Using with Docker

You can use the Docker image from Docker hub or GitHub Container Registry.

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

Anywhere else

Alternatively, you can install the latest binary (or the apt/rpm/deb/archlinux package) from this page.

Or, if you have Go installed, you can install the latest version of DNSControl with the following command:

go install github.com/StackExchange/dnscontrol/v4@main

Update

Update to the latest version depends on how you choose to install dnscontrol on your machine.

Update with Homebrew

brew upgrade dnscontrol

Alternatively, you can grab the latest binary (or the apt/rpm/deb package) from this page.

v4.30.0

Greetings DNS fans!

BIG CHANGES (please test before using this release in production):

• We've upgraded the library that parses command line flags. The conversion went smoothly for everything but shell-completion which required some wrangling that was difficult to test. Please do extra testing before using this in production.
• The Monthly DNSControl Community Video Conference Call moved to a new day and time (see below) to be more compatible with North America's west coast (Ok, that's not a software change but...)

HIGHLIGHTS

• Improvements to CLOUDNS: It is now also a registrar! Plus, GeoDNS support, better docs, SRV fixes, better rate-limiting.
• Improvements to PORKBUN: Support added for SSHFP, URL, and URL301 record.
• Improvements to BunnyDNS: Added TLSA support.
• And much more!

Thanks to all contributors involved in this release! This is a community project and we couldn't do it without all of your contributions!

Sincerely,
--Tom Limoncelli

Monthly video call!

Everyone is invited to the Monthly DNSControl Community Video Conference Call on the 2nd Tuesday of each month. Join whether you are a new user with questions or an experienced developer that wants to discuss DNSControl internals... or anything in between! Meeting details on GitHub Discussions.

Changelog

Provider-specific changes:

• 8125a35: CLOUDNS: Add GeoDNS support (#3944) (@anolek)
• 96a7bf3: CLOUDNS: Update capabilities documentation (#3964) (@tlimoncelli)
• 7504767: CLOUDNS: add registrar support (#3961) (@RobinDaugherty)
• a7e2307: CLOUDNS: allow SRV record with null target (#3957) (@RobinDaugherty)
• 590774f: CLOUDNS: pause when API fails due to rate limit (#3962) (@RobinDaugherty)
• 6d0db4c: DIGITALOCEAN: SOA is suppported (#3966) (@chicks-net)
• 704cb7f: DIGITALOCEAN: Update feature table for provider (#3958) (@chicks-net)
• 1fda952: OVH: Allow Null MX Record (#3938) (@anolek)
• 154e95f: PORKBUN: Add support for SSHFP record types. (#3968) (@darkrain42)
• 751ae63: PORKBUN: skip NS only APEX test (#3950) (@imlonghao)
• f4b402b: PORKBUN: support URL and URL301 (#3951) (@imlonghao)

Documentation:

• a0ea3f6: DOCS: BIND Provider - filenameformat fixes (#3945) (@andrewimeson)
• 6edfbf5: DOCS: Remove reference to ppush/ppreview, spelling fixes (#3940) (@andrewimeson)

CI/CD:

• 1ca6c61: Build(deps): Bump alpine from 3.22.2 to 3.23.2 (#3952) (@dependabot[bot])

Dependencies:

• fc411f0: CHORE: Update dependencies (#3963) (@tlimoncelli)

Other changes and improvements:

• d50aef0: Add TLSA support for BunnyDNS (#3943) (@baalajimaestro)
• 05eade1: CHORE: Upgrade to github.com/urfave/cli/v3 (#3948) (@tlimoncelli)
• 5fe3523: CHORE: generate-all.sh (#3969) (@tlimoncelli)
• bf89991: FIX: Type definitions to allow passing meta object as second parameter (#3947) (@andrewimeson)

Deprecation warnings

Warning

• REV() will switch from RFC2317 to RFC4183 in v5.0. This is a breaking change. Warnings are output if your configuration is affected. No date has been announced for v5.0. See https://docs.dnscontrol.org/language-reference/top-level-functions/revcompat
• NAMEDOTCOM, OPENSRS and SOFTLAYER need maintainers! These providers have no maintainer. Maintainers respond to PRs and fix bugs in a timely manner, and try to stay on top of protocol changes.

Install

macOS and Linux

Install with Homebrew (recommended)

brew install dnscontrol

Using with Docker

You can use the Docker image from Docker hub or GitHub Container Registry.

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

Anywhere else

Alternatively, you can install the latest binary (or the apt/rpm/deb/archlinux package) from this page.

Or, if you have Go installed, you can install the latest version of DNSControl with the following command:

go install github.com/StackExchange/dnscontrol/v4@main

Update

Update to the latest version depends on how you choose to install dnscontrol on your machine.

Update with Homebrew

brew upgrade dnscontrol

Alternatively, you can grab the latest binary (or the apt/rpm/deb package) from this page.

v4.29.0

Greetings DNS fans!

POTENTIAL BREAKING CHANGES:

• "fmt" now defaults to writing to dnsconfig.js. If you use ">" instead of "-o", check your scripts!
• The date/time of the Monthly DNSControl Community Video Conference Call will change in January. Look for updates on Github in the next week or so.

Highlights:

• "--notify" can be enabled in creds.json so that (for example) you always get notified on "push" (#3910) (@michaelkaye)
• "fmt" with no options reformats dnsconfig.js in place (This may break some scripts, but its a beta feature). It also is silent when no changes made. Use "-v" to always output the file names. See #3927 for details (#3927) (@tlimoncelli)

Bug fixes:

• 51bf2e3: BIND get-zones now works when using %D (#3930) (@tlimoncelli)
• f7c145a: The RP record type was broken in many ways: It ignored the DefaultTTL() setting, it didn't output errors (the record was silently ignored), and a lot of the validation that old-style types benefit from were not replicated in the new code. (#3931) (@tlimoncelli)
• A lot of code was refactored to be more consistent. None of that should change user-visible behavior.

Thanks to all contributors involved in this release! This is a community project and we couldn't do it without all of your contributions!

Sincerely,
--Tom Limoncelli

Monthly video call!

Everyone is invited to the Monthly DNSControl Community Video Conference Call on the 3rd Monday of each month. Join whether you are a new user with questions or an experienced developer that wants to discuss DNSControl internals... or anything in between! Meeting details on
GitHub Discussions.

Changelog

Major features:

• efe713c: FEATURE: Set --notify via creds.json so that preview or push can always notify (#3910) (@michaelkaye)
• 9076f40: NEW FEATURE: Make "fmt" more like other formatters (warning: New default for -o) (#3927) (@tlimoncelli)

Provider-specific changes:

• dc1bc46: DOCS: POWERDNS: Improve powerdns provider metadata documentation (#3925) (@ecraven)

Documentation:

• 97d8c66: DOCS: Added code examples for new notification options (#3928) (@cafferata)
• 1431526: DOCS: Document no_ns (#3926) (@tlimoncelli)
• 2a8e810: DOCS: Fix RP page (#3920) (@tlimoncelli)
• 9bb022c: DOCS: Modernize URls in writing-providers.md (#3929) (@tlimoncelli)

CI/CD:

• 9c55dca: Build(deps): Bump actions/cache from 4.3.0 to 5.0.1 (#3915) (@dependabot[bot])
• b559eec: Build(deps): Bump actions/upload-artifact from 5.0.0 to 6.0.0 (#3914) (@dependabot[bot])
• 15cae56: CICD: Update release notes template (#3903) (@tlimoncelli)

Dependencies:

• 1377d00: CHORE: Update dependencies (#3934) (@tlimoncelli)

Other changes and improvements:

• 51bf2e3: BUGFIX: BIND Fix get-zones for bind when using %D (#3930) (@tlimoncelli)
• f7c145a: BUGFIX: Multiple bugs in RP (RecordConfig v2) (#3931) (@tlimoncelli)
• dcdc252: BUGFIX: RecordConfig v2 wasn't processing record meta data (#3932) (@tlimoncelli)
• 41efba6: CHORE: Fix Raw/ASCII/Unicode order (linting) (#3933) (@tlimoncelli)
• 749db2c: CHORE: Linting (#3907) (@tlimoncelli)
• 7ab7d14: CHORE: Move non-provider code out of /providers (#3916) (@tlimoncelli)
• 43d2fa8: CHORE: Update the link to future video meetings (#3917) (@tlimoncelli)
• ecbfa9b: CHORE: remove underscores from filenames for consistency (#3909) (@chicks-net)
• cba298b: Other changes and improvements: Show zone.UniqueName instead of zone.Name in informational output. (#3923) (@ecraven)
• 6d4a185: REFACTOR: Run moderize -fix (#3908) (@tlimoncelli)

Deprecation warnings

Warning

• REV() will switch from RFC2317 to RFC4183 in v5.0. This is a breaking change. Warnings are output if your configuration is affected. No date has been announced for v5.0. See https://docs.dnscontrol.org/language-reference/top-level-functions/revcompat
• NAMEDOTCOM, OPENSRS and SOFTLAYER need maintainers! These providers have no maintainer. Maintainers respond to PRs and fix bugs in a timely manner, and try to stay on top of protocol changes.

Install

macOS and Linux

Install with Homebrew (recommended)

brew install dnscontrol

Using with Docker

You can use the Docker image from Docker hub or GitHub Container Registry.

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

Anywhere else

Alternatively, you can install the latest binary (or the apt/rpm/deb/archlinux package) from this page.

Or, if you have Go installed, you can install the latest version of DNSControl with the following command:

go install github.com/StackExchange/dnscontrol/v4@main

Update

Update to the latest version depends on how you choose to install dnscontrol on your machine.

Update with Homebrew

brew upgrade dnscontrol

Alternatively, you can grab the latest binary (or the apt/rpm/deb package) from this page.

v4.28.2

Greetings DNS fans!

This is a bugfix release. BIND users discovered that "push" was regenerating zonefiles even when there was no change. The reason was that the %D verb was always "" (null string). Shout out to @ondohotola for quickly reporting this bug and confirming the workaround. A full fix is included in v4.28.2.

This release also includes some documentation and tool improvements.

Thanks to all contributors involved in this release! This is a community project and we couldn't do it without all of your contributions!

Sincerely,
--Tom Limoncelli

Monthly video call!

Everyone is invited to the Monthly DNSControl Community Video Conference Call on the 3rd Monday of each month. Join whether you are a new user with questions or an experienced developer that wants to discuss DNSControl internals... or anything in between! Meeting details on GitHub Discussions.

Changelog

Documentation:

• 986bc4c: DOCS: replace all NewRegistrar('ThirdParty') (#3889) (@SukkaW)

Dependencies:

• 08a6fa6: CHORE: Update deps, regenerate docs (#3902) (@tlimoncelli)

Other changes and improvements:

• 0ae4acc: BUGFIX: BIND %D not working after v4.28.0 (#3900) (@tlimoncelli)
• 865dad5: TOOLS: bin/generate-all.sh should skip .vscode (#3901) (@tlimoncelli)
• db27a1e: [docs] Refresh digital ocean provider docs (#3860) (@chicks-net)

Deprecation warnings

Warning

• REV() will switch from RFC2317 to RFC4183 in v5.0. This is a breaking change. Warnings are output if your configuration is affected. No date has been announced for v5.0. See https://docs.dnscontrol.org/language-reference/top-level-functions/revcompat
• NAMEDOTCOM and SOFTLAYER need maintainers! These providers have no maintainer. Maintainers respond to PRs and fix bugs in a timely manner, and try to stay on top of protocol changes.

Install

macOS and Linux

Install with Homebrew (recommended)

brew install dnscontrol

Using with Docker

You can use the Docker image from Docker hub or GitHub Container Registry.

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

Anywhere else

Alternatively, you can install the latest binary (or the apt/rpm/deb/archlinux package) from this page.

Or, if you have Go installed, you can install the latest version of DNSControl with the following command:

go install github.com/StackExchange/dnscontrol/v4@main

Update

Update to the latest version depends on how you choose to install dnscontrol on your machine.

Update with Homebrew

brew upgrade dnscontrol

Alternatively, you can grab the latest binary (or the apt/rpm/deb package) from this page.

v4.28.1

Greetings DNS fans!

This release fixes a bug found shortly after v4.28.0 was released. It only affects users of the "split horizons" feature.

Version v4.28.0 was a big release with many changes. We still recommend exercising great caution before putting it into production. See the v4.28.0 release notes for testing advice. Please file a bug report if you find any issues.

Thanks to gvengel for reporting the bug so quickly.

Changelog

Other changes and improvements:

• a0288bd: bug(split horizon): Domains with split horizons not working (#3895) (@tlimoncelli)

Deprecation warnings

Warning

• REV() will switch from RFC2317 to RFC4183 in v5.0. This is a breaking change. Warnings are output if your configuration is affected. No date has been announced for v5.0. See https://docs.dnscontrol.org/language-reference/top-level-functions/revcompat
• NAMEDOTCOM and SOFTLAYER need maintainers! These providers have no maintainer. Maintainers respond to PRs and fix bugs in a timely manner, and try to stay on top of protocol changes.

Install

macOS and Linux

Install with Homebrew (recommended)

brew install dnscontrol

Using with Docker

You can use the Docker image from Docker hub or GitHub Container Registry.

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

Anywhere else

Alternatively, you can install the latest binary (or the apt/rpm/deb/archlinux package) from this page.

Or, if you have Go installed, you can install the latest version of DNSControl with the following command:

go install github.com/StackExchange/dnscontrol/v4@main

Update

Update to the latest version depends on how you choose to install dnscontrol on your machine.

Update with Homebrew

brew upgrade dnscontrol

Alternatively, you can grab the latest binary (or the apt/rpm/deb package) from this page.