Greetings DNS fans!
This is a pre-release. If you use DS records, please test this extensively.
The DS record type has been rewritten to use the new RecordConfigv2 struct. It should be entirely backwards compatible with older providers. However, to be extra cautious, I'm releasing this as a pre-release.
It currently passes all integration tests on the platforms I have access to.
- Test with providers not listed here: https://github.com/StackExchange/dnscontrol/actions/runs/21334415887
- Please test in your environment (with caution!). Please use
previewfirst. Try deleting, creating, and modifying DS records.
This is on a tight schedule. If I don't hear of any show-stopper bugs, it will be merged on Monday, Feb 2, 2026.
Thanks!
--Tom Limoncelli
Changelog
Other changes and improvements:
- 906495a: REFACTOR: Rewrite DS to use RecordConfigV2 (#3996) (@tlimoncelli)
Install
macOS and Linux
Install with Homebrew (recommended)
brew install 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/stackexchange/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/StackExchange/dnscontrol/v4@mainUpdate
Update to the latest version depends on how you choose to install dnscontrol on your machine.
Update with Homebrew
brew upgrade dnscontrolAlternatively, you can grab the latest binary (or the apt/rpm/deb package) from this page.