DNSControl Files

Greetings DNS fans!

Highlights: * 9e73e7370ac5677c3ffecac5d0851eb8ff521043: BunnyDNS users will be happy to learn that DNSControl has been updated to allow SRV "." targets, which BunnyDNS only recently started supporting (#4003) * ae9759d831ed67a3c0602a58d9733335fe3d2174: 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:

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

Documentation:

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

Dependencies:

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

Other changes and improvements:

• c529d9d77bcae3d99f284d9f6503c610b95a14e7: BUGFIX: RecordConfigv2 should fix records from legacy providers (#4001) (@tlimoncelli)
• 5be6467c722803ad9e359b016914a97442aa4007: CHORE: Use modernize -fix to update code (#4005) (@tlimoncelli)
• 16ee9d1772e4e78dc56867c0a2741221a5cb8ee9: CHORE: generate-all.sh (#4008) (@tlimoncelli)
• 79d42a6d631d5aaddae606253d7f9f9b51733bf4: REFACTOR: Move model.RRtoRC* to its own package dnsrr (#3999) (@tlimoncelli)
• dee2b047479b0f0510cad32079affdec5ab22e08: 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)

:::shell
brew install dnscontrol

Using with Docker

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

:::shell
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:

:::shell
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

:::shell
brew upgrade dnscontrol

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