Greetings DNS fans!
Release highlights
- NEW PROVIDER: DNSControl now supports IONOS! Thanks and welcome to @n-rodriguez who joins the project as its maintainer. We look forward to great things! (#5064)
print-irandpreview --irfinally round-trip again. This was broken in v5 and has finally been fixed. It could use more testing. (#5085)D("../../example.com", ...)is no longer permitted. It shouldn't have worked before, but now its an error. #5091- BIG REFACTORING: Code that normalized and validated dnsconfig.js file data has been refactored to be cleaner and more maintainable.
- Valid dnsconfig.js files should still work as before with no (intentional) changes in behavior. That said, it might be worthwhile doing a little extra testing before putting this into production. A simple "dnscontrol preview" should show no differences when compared to an earlier release.
- Invalid dnsconfig.js files will see errors reported earlier in the pipeline (during "preview" instead of "push): Invalid CAA tags, invalid OPENPGPKEY keys, PTR records in the wrong zone
- The following features generate DNS records that were never checked for errors. Now they are checked: SPF splitting, IMPORT_TRANSFORM and the A record transform metadata
- Some error messages were output twice. Now they are only output once.
Valid dnsconfig.js files should see zero behavior changes. Apologies in advance if anything breaks. Please report all bugs or unexpected changes!
Thanks!
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.
Experimental: Try the new D() syntax!
Select credential entries directly with REGISTRAR() and SERVICE() in dnsconfig.js. The legacy syntax remains supported; this revision replaces the experimental PROVIDER()/DNS_SERVICE() syntax from v5.3.0. See the examples in the conversion guide. Please test it and share feedback!
Changelog
Provider-specific changes:
- 7f83940: feat(p/IONOS): new provider: IONOS hosting DNS provider (#5064) (@n-rodriguez)
- 83c293e: feat(p/PORKBUN): support DS records for delegated subdomains (#5073) (@philpennock)
Bug fixes:
- d252461: fix(dnsconfig): reject domain names and tags that escape the zone directory (#5091) (@TomOnTime)
- 62af2f0: fix: print-ir and --ir should round-trip (#5085) (@TomOnTime)
Refactoring:
- 5da338d: refactor(normalize): move CAA and OPENPGPKEY checks to their makers (#5086) (@TomOnTime)
- 495d2f9: refactor(normalize): move PTR magic and arpa label stripping to import (#5087) (@TomOnTime)
- fb55a90: refactor(normalize): remove no-op record normalization (#5090) (@TomOnTime)
- 845815a: refactor(normalize): run ValidateAndNormalizeConfig in ordered phases (#5089) (@TomOnTime)
- 2239ae6: refactor(normalize): split validate.go into one file per concern (#5088) (@TomOnTime)
Deprecation warnings
Warning
- REV() will switch from RFC2317 to RFC4183 sometime after v5.0 is released. This is a breaking change. Warnings are output if your configuration is affected. 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 trust --formula dnscontrol/tap/dnscontrol
brew install DNSControl/tap/dnscontrolUsing with Docker
You can use the Docker image from Docker hub or GitHub Container Registry.
docker run --rm -it -v "$(pwd):/dns" ghcr.io/dnscontrol/dnscontrol previewAnywhere 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/DNSControl/dnscontrol/v4@mainUpdate
Update to the latest version depends on how you choose to install dnscontrol on your machine.
Update with Homebrew
brew upgrade DNSControl/tap/dnscontrolAlternatively, you can grab the latest binary (or the apt/rpm/deb package) from this page.
Verify downloads
This release ships two supply-chain guarantees:
checksums.txt.sigstore.json— a keyless cosign Sigstore bundle (signature, signing certificate, and transparency-log entry in one file) overchecksums.txt, issued to this repo's release workflow. Sincechecksums.txtcovers every release artifact, verifying it verifies your download transitively.multiple.intoto.jsonl— SLSA Level 3 provenance for all release artifacts, generated by slsa-github-generator.
# Verify the checksums.txt signature (download checksums.txt and
# checksums.txt.sigstore.json first):
cosign verify-blob checksums.txt \
--bundle checksums.txt.sigstore.json \
--certificate-identity-regexp 'https://github\.com/DNSControl/dnscontrol/\.github/workflows/release_draft\.yml@refs/(tags|heads)/' \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
# Then check your download against checksums.txt:
Linux: sha256sum --ignore-missing -c checksums.txt
macOS: shasum -a 256 --ignore-missing -c checksums.txt