v4.22.0

[tlimoncelli]

Greetings, DNS fans!

This is a BIG release! You should do extra testing before you put this into production. MSDNS and get-certs are removed. 2 new providers added. Many, many, other improvements!

Breaking changes:

• get-certs subcommand is removed. It has been unsupported since December 2022 and warnings that it would be removed in July 2025 started about a year ago.
• MSDNS (ActiveDirectory DNS) provider has been removed, as it can no longer be supported.

Other exciting news:

• New providers: ADGUARDHOME, FORTIGATE
• These providers now support concurency: LUADNS, MYTHICBEASTS, PORKBUN
• The --notify flag now makes errors visible to ease debugging
• The documentation list of providers is reorganized into smaller charts
• Many documentation fixes including many broken links now work
• The User-Agent now properly includes a version number
• Many, many, dependencies have been upgraded, including the newest PowerDNS and LUADNS SDKs.

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

Sincerely,
Tom

Changelog

Major features:

• d042b3e: FEATURE: --notify now makes errors visible to make debugging easier (FEATURE: --notify now makes errors visible to make debugging easier #3614) (@hmoffatt)
• 3ea7ea8: FEATURE: Support ignoring the ech= parameter in HTTPS/SVCB RR types (FEATURE: Support ignoring the ech= parameter in HTTPS/SVCB RR types #3485) (@gucci-on-fleek)
• e1830ab: NEW PROVIDER: ADGUARDHOME (NEW PROVIDER: ADGUARDHOME #3638) (@ishanjain28)

Provider-specific changes:

• 855624a: DIGITALOCEAN: DOCS: update instructions for creating API token (DIGITALOCEAN: DOCS: update instructions for creating API token #3617) (@hmoffatt)
• 5a2a53c: FORTIGATE: Fix init provider (FORTIGATE: Fix init provider #3654) (@KlettIT)
• e9b49e2: LUADNS: Support HTTPS record type, enable concurrency, adopt newest SDK (LUADNS: Support HTTPS record type, enable concurrency, adopt newest SDK #3640) (@riku22)
• 4efa09b: MYTHICBEASTS: Mark as concurrent verified. (MYTHICBEASTS: Mark as concurrent verified. #3631) (@tomfitzhenry)
• e5eab4f: MYTHICBEASTS: Performance improvement: Use the OAuth2 client credentials protocol (MYTHICBEASTS: Performance improvement: Use the OAuth2 client credentials protocol #3629) (@tomfitzhenry)
• 75821a8: NS1: code reorganization (NS1: code reorganization #3622) (@costasd)
• 4ce1935: PORKBUN: Improve retry handling, mark as concurrent (PORKBUN: Improve retry handling, mark as concurrent #3652) (@jamesog)
• 4672409: PORKBUN: fix SVCB params (PORKBUN: fix SVCB params #3650) (@imlonghao)

Documentation:

• 0d081ba: DOCS: RWTH provider is only available via the intranet (DOCS: RWTH provider page - Broken link(s) #3497) (DOCS: RWTH provider is only available via the intranet (#3497) #3623) (@MisterErwin)
• a8c41d9: DOCS: Added requested provider Sav.com (DOCS: Added requested provider Sav.com #3635) (@cafferata)
• 1a7cb20: DOCS: Added requested providers Scaleway (DOCS: Added requested providers Scaleway #3609) (@cafferata)
• 0a4162f: DOCS: How to add a requested provider (DOCS: How to add a requested provider #3636) (@cafferata)
• 1f8b7d0: DOCS: Linkspector URI fixes (DOCS: Linkspector URI fixes #3625) (@cafferata)
• e5f4d97: DOCS: [GitBook] Refactor structure to match URL paths and fix missing page links (DOCS: [GitBook] Refactor structure to match URL paths and fix missing page links #3613) (@cafferata)
• b2e3775: DOCS: add links to help jump to provider table anchors (DOCS: add links to help jump to provider table anchors #3619) (@chicks-net)

CI/CD:

• adfe033: Build(deps): Bump brace-expansion from 2.0.1 to 2.0.2 (Build(deps): Bump brace-expansion from 2.0.1 to 2.0.2 #3632) (@dependabot[bot])
• 9fc9814: Build(deps): Bump github.com/go-viper/mapstructure/v2 from 2.2.1 to 2.3.0 (Build(deps): Bump github.com/go-viper/mapstructure/v2 from 2.2.1 to 2.3.0 #3644) (@dependabot[bot])

Dependencies:

• 0d60e0c: CHORE: Update dependencies (CHORE: Update dependencies #3643) (@tlimoncelli)
• 6fdbac7: CHORE: Update dependencies (CHORE: Update dependencies #3659) (@tlimoncelli)
• f825243: CHORE: Update dependencies (CHORE: Update dependencies #3666) (@tlimoncelli)
• b66251b: CHORE: update dependencies and fmt (CHORE: update dependencies and fmt #3655) (@tlimoncelli)

Other changes and improvements:

• 919ce24: BUG: Fix --notify on preview and on error (BUG: Fix --notify on preview and on error #3616) (@hmoffatt)
• 74e1bb5: BUG: Output better "version" string when running main.go directly (BUG: Output better "version" string when running main.go directly #3658) (@jamesog)
• cd8892f: BUG: User-Agent should include DNSControl version (BUG: User-Agent should include DNSControl version #3653) (@jamesog)
• d37736e: CHORE: Linting (CHORE: Linting #3645) (@tlimoncelli)
• a0d04a1: CHORE: Remove "get-certs" command (CHORE: Remove "get-certs" command #3657) (@tlimoncelli)
• 1ccd5eb: CHORE: Remove the MSDNS provider (CHORE: Remove the MSDNS provider #3656) (@tlimoncelli)
• a8a3ea7: CHORE: remove unused module pkg/acme (get-certs) (CHORE: remove unused module pkg/acme (get-certs) #3667) (@tlimoncelli)
• 3bdbb48: NEW PROVIDE: FORTIGATE (NEW PROVIDE: FORTIGATE #3642) (@KlettIT)
• 874ba79: REFACTOR: Rename commands/zonecache.go (REFACTOR: Rename commands/zonecache.go #3646) (@tlimoncelli)
• 8a6baa7: Reapply "CHORE: Remove the MSDNS provider (CHORE: Remove the MSDNS provider #3656)" (@tlimoncelli)
• 81a916c: Remove docs (@tlimoncelli)
• e0e610c: Remove docs (@tlimoncelli)
• e9f1360: Revert "CHORE: Remove the MSDNS provider (CHORE: Remove the MSDNS provider #3656)" (@tlimoncelli)
• 50e4bfb: Revert "Remove docs" (@tlimoncelli)
• c5e9cd1: Revert "Remove docs" (@tlimoncelli)
• 188343d: Revert "remove commands/getCerts.go" (@tlimoncelli)
• e3b6141: chore: update go-powerdns to v0.6.7 and adjust SOAEditAPI type (chore: update go-powerdns to v0.6.7 and adjust SOAEditAPI type #3664) (@jpbede)
• 1fa31c7: remove commands/getCerts.go (@tlimoncelli)

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
• MSDNS maintainer needed! Without a new volunteer, this DNS provider will lose support after April 2025. See New maintainer for MSDNS needed! #2878
• NAMEDOTCOM 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.
• get-certs/ACME support is frozen and will be removed without notice between now and July 2025. It has been unsupported since December 2022. If you don't use this feature, do not start. If you do use this feature, migrate ASAP. See discussion in issues/1400

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.

---

This discussion was created from the release v4.22.0.

[ishanjain28]

Hii @tlimoncelli,

The docs pages do not show adguardhome yet.
https://docs.dnscontrol.org/provider/adguardhome

Do I need to update something to make this work?

[tlimoncelli]

Oops! It looks like we skipped Step 9 (and maybe 15) in https://docs.dnscontrol.org/developer-info/writing-providers#step-9-update-docs-cicd-and-other-files

Would you mind sending a PR?