Skip to content

v5.10.1

Latest

Choose a tag to compare

@github-actions github-actions released this 20 Nov 11:52
Immutable release. Only release title and notes can be modified.
6210379

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:

CI/CD:

Other changes and improvements:

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/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/dnscontrol/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/DNSControl/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/tap/dnscontrol

Alternatively, 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) over checksums.txt, issued to this repo's release workflow. Since checksums.txt covers 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