New release: dnscontrol v4.17.0

[Tom Limoncelli]

v4.17.0

Greetings DNS fans!

This is mostly a bugfix release. Most notable is that @eliheady fixed how split horizon domains work with the push --domains flag. Not only are the bugs fixed, but wildcards now work! See https://docs.dnscontrol.org/commands/preview-push for details.

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

Best,
Tom

Changelog

Major features:

• 48c99f7: Improve tagged domain handling in support of Split Horizon feature (#3444) (@eliheady)

Provider-specific changes:

• 2c56f68: CLOUDFLAREAPI: Future-proof how ALIAS is handled (#3436) (@tlimoncelli)
• ea645bf: DNSMADEEASY: populate zone cache after creating zone (#3333) (@das7pad)
• ad308f6: OVH: Bugfix: Native DMARC records rejected for subdomains (#3440) (@masterzen)
• 063d8b0: BUNNY_DNS: Add support for Redirect record (#3472) (@stevenrombauts)

Documentation:

• f3bdb17: DOCS: Fix quoting issue in D.md (#3446) (@labrown)
• e91289b: DOCS: Fixes broken GitHub badge (#3438) (@cafferata)
• 83a36a6: DOCS: SOA RNAME description isn't accurate (#3481) (@jpmens)
• 5c18be2: DOCS: Update migrating.md to match BIND's current behavior (#3454) (@udf2457)
• e0e32ca: DOCS: fix broken links (#3437) (@imlonghao)
• 0d92d7a: DOCS: fix link to writing-providers.md (#3430) (@nyanotech)

CI/CD:

• 59183f3: Build(deps): Bump actions/cache from 4.2.0 to 4.2.1 (#3459) (@dependabot[bot])
• bd2c940: Build(deps): Bump actions/cache from 4.2.1 to 4.2.2 (#3480) (@dependabot[bot])
• 6aeacc6: Build(deps): Bump actions/upload-artifact from 4.6.0 to 4.6.1 (#3458) (@dependabot[bot])
• 38fd85a: Build(deps): Bump alpine from 3.21.2 to 3.21.3 (#3478) (@dependabot[bot])
• 1962fb8: Build(deps): Bump github.com/go-jose/go-jose/v4 from 4.0.4 to 4.0.5 (#3465) (@dependabot[bot])

Dependencies:

• 8c3903e: CHORE: update deps; go generate (#3455) (@tlimoncelli)

Other changes and improvements:

• b0bc29c: BUG: get-zones not generating SOA() statements properly (#3464) (@tlimoncelli)
• f8ae1ee: Bug: HASH() outputs debug info (#3483) (@jpmens)
• c01bfdc: CHORE: Future proof CAA integration test (#3449) (@tlimoncelli)
• f281698: CHORE: Update dependencies (#3484) (@tlimoncelli)
• 311b6d8: REFACTOR: Split integration_test.go (it should mostly contain data tables) (#3420) (@tlimoncelli)
• 3f8f9e7: refactor(RecordConfig): Use ChangeType() instead of assignment (#3441) (@tlimoncelli)
• 2c4cc0c: refactor(current-domain) Remove dot from current-domain (#3433) (@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
• MSDNS maintainer needed! Without a new volunteer, this DNS provider will lose support after April 2025. See #2878
• 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.
• get-certs/ACME support is frozen and will be removed without notice between now and July 2025. It has been unsupported since December 2022. If you don't use this feature, do not start. If you do use this feature, migrate ASAP. See discussion in issues/1400

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.

—

This release has 14 assets:

• checksums.txt
• dnscontrol-4.17.0.amd64.deb
• dnscontrol-4.17.0.arm64.deb
• dnscontrol-4.17.0.arm64.rpm
• dnscontrol-4.17.0.x86_64.rpm
• dnscontrol_4.17.0_darwin_all.tar.gz
• dnscontrol_4.17.0_freebsd_amd64.tar.gz
• dnscontrol_4.17.0_freebsd_arm64.tar.gz
• dnscontrol_4.17.0_linux_amd64.tar.gz
• dnscontrol_4.17.0_linux_arm64.tar.gz
• dnscontrol_4.17.0_windows_amd64.zip
• dnscontrol_4.17.0_windows_arm64.zip
• Source code (zip)
• Source code (tar.gz)

Visit the release page to download them.