DNSControl Files

Greetings DNS fans!

BIG CHANGES (please test before using this release in production):

• We've upgraded the library that parses command line flags. The conversion went smoothly for everything but shell-completion which required some wrangling that was difficult to test. Please do extra testing before using this in production.
• The Monthly DNSControl Community Video Conference Call moved to a new day and time (see below) to be more compatible with North America's west coast (Ok, that's not a software change but...)

HIGHLIGHTS

• Improvements to CLOUDNS: It is now also a registrar! Plus, GeoDNS support, better docs, SRV fixes, better rate-limiting.
• Improvements to PORKBUN: Support added for SSHFP, URL, and URL301 record.
• Improvements to BunnyDNS: Added TLSA support.
• And much more!

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:

• 8125a354f846df8674629da71272eccbaaf24d1b: CLOUDNS: Add GeoDNS support (#3944) (@anolek)
• 96a7bf309d45be5f4ddc66e3e03d4eb7b693b100: CLOUDNS: Update capabilities documentation (#3964) (@tlimoncelli)
• 7504767c75197914ba07c121f9889f49da7801fd: CLOUDNS: add registrar support (#3961) (@RobinDaugherty)
• a7e230735b3ad075a684049b21f8622c9b14fdfb: CLOUDNS: allow SRV record with null target (#3957) (@RobinDaugherty)
• 590774f5c8dccc171118f93e0fbca1a5171e05b9: CLOUDNS: pause when API fails due to rate limit (#3962) (@RobinDaugherty)
• 6d0db4c33b9b5778f8b4fb23ae204f91d65c4154: DIGITALOCEAN: SOA is suppported (#3966) (@chicks-net)
• 704cb7f65f417755b6ab4d2148107dcff338e4f5: DIGITALOCEAN: Update feature table for provider (#3958) (@chicks-net)
• 1fda952a2574f64850220a4f3b883cfb25bb32a6: OVH: Allow Null MX Record (#3938) (@anolek)
• 154e95f6dcafd3bbc05d99c6297be9c603bc7ff9: PORKBUN: Add support for SSHFP record types. (#3968) (@darkrain42)
• 751ae63a7116d8add81c51904d7e298903a46621: PORKBUN: skip NS only APEX test (#3950) (@imlonghao)
• f4b402bfce56d57fe870d3822883265005ac5130: PORKBUN: support URL and URL301 (#3951) (@imlonghao)

Documentation:

• a0ea3f6c5e4a591eaafed9bebef81d2dde3e9d28: DOCS: BIND Provider - filenameformat fixes (#3945) (@andrewimeson)
• 6edfbf507854b2792c40bf008c0d86cb71a381c7: DOCS: Remove reference to ppush/ppreview, spelling fixes (#3940) (@andrewimeson)

CI/CD:

• 1ca6c61f71511df1cf6f3db26dfe0761e5dcbc31: Build(deps): Bump alpine from 3.22.2 to 3.23.2 (#3952) (@dependabot[bot])

Dependencies:

• fc411f073ef3c8f70634bf3c80c6a45f51f644f0: CHORE: Update dependencies (#3963) (@tlimoncelli)

Other changes and improvements:

• d50aef0f77ef40d095b44d26afdb66d82b323b68: Add TLSA support for BunnyDNS (#3943) (@baalajimaestro)
• 05eade15c692118699d42f14c8285b873d9d87c2: CHORE: Upgrade to github.com/urfave/cli/v3 (#3948) (@tlimoncelli)
• 5fe352374e99a79fbc2d71dfe8bb9f42f614d8a9: CHORE: generate-all.sh (#3969) (@tlimoncelli)
• bf89991023be5392c7cae62875d712480d16c8e6: FIX: Type definitions to allow passing meta object as second parameter (#3947) (@andrewimeson)

Deprecation warnings

[!WARNING] - REV() will switch from RFC2317 to RFC4183 in v5.0. This is a breaking change. Warnings are output if your configuration is affected. No date has been announced for v5.0. 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)

:::shell
brew install dnscontrol

Using with Docker

You can use the Docker image from Docker hub or GitHub Container Registry.

:::shell
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:

:::shell
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

:::shell
brew upgrade dnscontrol

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