Skip to content

Releases: StackExchange/dnscontrol

v4.36.1

08 Mar 13:45
97b7b43

Choose a tag to compare

Greetings DNS fans!

This is a bugfix release:

  • macOS binaries are now properly signed! No more Gatekeeper warnings! Thanks @cafferata!
  • CLOUDFLAREAPI now runs 25% faster if you use pagerules and workers.
  • Binaries are now built using the most recent stable Go compiler (previously we were locked into Go 1.25)

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

Provider-specific changes:

  • dac7be8: CLOUDFLAREAPI: Performance improvements for "preview" when workers/redirects are managed (#4134) (@tlimoncelli)

CI/CD:

Deprecation warnings

Warning

Install

macOS and Linux

Install with Homebrew (recommended)
brew install StackExchange/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/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 StackExchange/tap/dnscontrol

Alternatively, you can grab the latest binary (or the apt/rpm/deb package) from this page.

v4.36.0

06 Mar 15:13
28ccc07

Choose a tag to compare

Greetings DNS fans!

Release Highlights:

  • Big update for DNSIMPLE! Added support for SVCB, HTTPS, TLSA, NullMX. Now uses diff2, thus making IGNORE() more reliable plus other features. Thanks, @onlyhavecans!
  • AXFRDDNS now supports OPENPGPKEY and SMIMEA records. Thanks @gucci-on-fleek!
  • GCLOUD now supports AutoDNSSEC. Thanks @miono!
  • The --cmax flag (preview/push) now defaults to 100. The old default (999) was just too large for some systems.

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.

Changelog

Provider-specific changes:

Documentation:

CI/CD:

Dependencies:

Other changes and improvements:

Deprecation warnings

Warning

Install

macOS and Linux

Install with Homebrew (recommended)
brew install StackExchange/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/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 StackExchange/tap/dnscontrol

Alternatively, you can grab the latest binary (or the apt/rpm/deb package) from this page.

v4.35.0

24 Feb 20:06
fe4f24c

Choose a tag to compare

Greetings DNS fans!

Summary:

  • Two new providers, both for network hardware! Users of Ubiquiti mesh hardware or the Mikrotik RouterOS will be happy to know the enw UNFI and MIKROTIK providers have arrived! Thanks to @zupolgec and @hedger!
  • There's now an MCP Server for the DNSControl documentation. https://docs.dnscontrol.org/developer-info/mcp-server Thanks @cafferata!
  • @cafferata completed many CI/CD pipeline improvements, too many to list them all. Installing DNSControl from brew on macOS systems should be significantly smoother starting with this release!
  • We bid farewell to the HEXONET provider. It is replaced by the CNR provider. Always glad to see vendors maintaining their own provider code. It's much appreciated!
  • Many (many!) small fixes and feature improvements. See below for details.

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.

Changelog

Major features:

Provider-specific changes:

Documentation:

CI/CD:

Dependencies:

Other changes and improvements:

Deprecation warnings

Warning

Install

macOS and Linux

Install with Homebrew (recommended)
brew install StackExchange/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/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 StackExchange/tap/dnscontrol

Alternatively, you can grab the latest binary (or the apt/rpm/deb package) from this page.

v4.34.0

10 Feb 16:44
8fa88fb

Choose a tag to compare

Greetings DNS fans!

POSSIBLE BREAKING CHANGE!

  • INWX USERS! If you use the NAMESERVER() operator, behavior has changed to be like all other providers. In the past you were unable to delete entries, only add to them. Now NAMESERVER() (if it exists in your D() statement) replaces the delegations at the registrar. Please test your configuration before putting this release into production. You may need to add NAMESERVER() statements.

Highlights:

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.

Changelog

Provider-specific changes:

Documentation:

CI/CD:

Dependencies:

Other changes and improvements:

Deprecation warnings

Warning

Install

macOS and Linux

Install with Homebrew (recommended)
brew install StackExchange/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/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 StackExchange/tap/dnscontrol

Alternatively, you can grab the latest binary (or the apt/rpm/deb package) from this page.

v4.33.1

03 Feb 13:32
fe8fcf4

Choose a tag to compare

Greetings DNS fans!

Summary: This is a bugfix release (and 2 small additions came along for the ride). If you use the new Cloudflare comments and tags feature, you can now remove those comments and tags too!

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.

Changelog

Provider-specific changes:

Dependencies:

Deprecation warnings

Warning

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.

v4.33.0

02 Feb 16:02
375b150

Choose a tag to compare

Greetings DNS fans!

WARNING: This release overhauled two internal systems. There should be no user-visible affects. However... please test carefully before putting it into production. What changed? (1) how DS records are managed (this doesn't affect many users), and (2) how IP addresses are managed (this affects everyone).

Highlights:

  • 2 new providers! GIDINET and INFOMANIAK! Grazie to @zupolgec for contributing Gidinet (both DNS provider and registrar) (#4004), and thanks to @jbelien for adding INFOMANIAK (also both DNS provider and registrar) (#3574)
  • 2 big refactoring projects: DS was rewritten to use the more modern RecordConfigV2 (#3996) and we converted net.IP to the more modern netip.Addr (#4012)
  • Cloudflare gained support for record comments, tags, and CNAME flattening thanks to @allixsenos
  • DESEC gained support for LOC record (#4011) thanks to @androw
  • DIGITALOCEAN doccs have been updated (#4029) thanks to @chicks-net (he also contributed #4041 which fixed many broken links)
  • JOKER now correctly updates TTLs on CAA and other records #4019 thanks to @grahammiln
  • And many other improvements!

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.

Changelog

Major features:

Provider-specific changes:

Documentation:

CI/CD:

Dependencies:

Other changes and improvements:

Deprecation warnings

Warning

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.

v4.33.0-beta1 (Please test if you use DS records!)

25 Jan 16:52
906495a

Choose a tag to compare

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.

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:

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.

v4.32.0

25 Jan 14:57
16ee9d1

Choose a tag to compare

Greetings DNS fans!

Highlights:

  • 9e73e73: BunnyDNS users will be happy to learn that DNSControl has been updated to allow SRV "." targets, which BunnyDNS only recently started supporting (#4003)
  • ae9759d: Cloudflare users will be happy to know that the warnings the CF Dashboard displays about TXT records are a thing of the past... at least for TXT records created and or updated starting with this version (#3834) (@tlimoncelli)
  • Many documentation improvements, including links to RFCs (#3970 thanks to @grahammiln!) and info on how to use VSCode and the Go Debugger (#3998)
  • Internal improvements continue on the RecordConfigv2 project. Legacy providers (which is all of them, currently) are better supported.

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.

Changelog

Provider-specific changes:

Documentation:

Dependencies:

Other changes and improvements:

Deprecation warnings

Warning

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.

v4.31.1

21 Jan 19:03
8470260

Choose a tag to compare

Greetings DNS fans!

If you use the SPF optimizer, do NOT use v4.31.0. This release fixes the regression.

Version 4.31.0 introduced a bug in the SPF optimizer. Eagle-eyed @sourgrasses found and fixed the problem! Thanks!

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

Bug fixes:

CI/CD:

Deprecation warnings

Warning

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.

v4.31.0

20 Jan 19:05
37e7c1f

Choose a tag to compare

Greetings DNS fans!

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

Highlights:

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

Provider-specific changes:

Documentation:

Dependencies:

Other changes and improvements:

Deprecation warnings

Warning

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.