Repository navigation
Greetings DNS fans!
Release highlights
Just one quick bugfix related to "preview --ir" plus some non-code (docs and CI) fixes. Enjoy!
Thanks!
Thanks to all contributors involved in this release! This is a community project done entirely by volunteers. We 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
Documentation:
- cc95a67: docs: update REFACTORING_PROJECTS and release notes template (#5122) (@TomOnTime)
CI/CD:
- cd6377f: ci: correct stale download-artifact pin comment (#5126) (@chicks-net)
Other changes and improvements:
- 6210379: commands: add NameFQDN when importing --ir (#5127) (@yuyuyureka)
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