DNSControl Files

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:

• 51bf2e34d0b16d6096bd47df512370103f9cf1bb: BIND get-zones now works when using %D (#3930) (@tlimoncelli)
• f7c145a54c3e32bbe9f560e7b56b646f81e5c902: 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:

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

Provider-specific changes:

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

Documentation:

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

CI/CD:

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

Dependencies:

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

Other changes and improvements:

• 51bf2e34d0b16d6096bd47df512370103f9cf1bb: BUGFIX: BIND Fix get-zones for bind when using %D (#3930) (@tlimoncelli)
• f7c145a54c3e32bbe9f560e7b56b646f81e5c902: BUGFIX: Multiple bugs in RP (RecordConfig v2) (#3931) (@tlimoncelli)
• dcdc2527220fb238f9a503ce1d5f89ec096b89f9: BUGFIX: RecordConfig v2 wasn't processing record meta data (#3932) (@tlimoncelli)
• 41efba6f0323048c3acb70a9d720112a3dec024c: CHORE: Fix Raw/ASCII/Unicode order (linting) (#3933) (@tlimoncelli)
• 749db2ca78240dac46c3526feef9278cb21e0274: CHORE: Linting (#3907) (@tlimoncelli)
• 7ab7d147fbf4e4c540841c0dc33b85657af46014: CHORE: Move non-provider code out of /providers (#3916) (@tlimoncelli)
• 43d2fa891733758854e696e63594e75ebf4b4bed: CHORE: Update the link to future video meetings (#3917) (@tlimoncelli)
• ecbfa9b4a0d8f57e629722ecdaa0ea6b39bf7902: CHORE: remove underscores from filenames for consistency (#3909) (@chicks-net)
• cba298b6df679b7c6694a9187695394866cd431a: Other changes and improvements: Show zone.UniqueName instead of zone.Name in informational output. (#3923) (@ecraven)
• 6d4a185422e19bce705e9c497e5d213b9f26d466: 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)

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