DNSControl Files

Greetings DNS fans!

This is mostly a bugfix release. Some highlights include:

• 475f99b8d58725cc50aa2292892888460cb600ad: D_EXTEND works better with REV, some bugs still remain (#3488) (@tlimoncelli)
• 7661175d589327eb7327f0fece44a5f08e4e6e4f: typescript improvements for require_glob optional (#3508) (@labrown)
• 0097b63a20a664b6aebf723b4860cae050afc1cb: CLOUDFLARE: Changed how CF_REDIRECT names are generated. Your next "push" will rename things.
• 14c3acb8019e226be672c9862fc2d3cc3d36cc3a: CLOUDFLARE: SINGLE_REDIRECT now permits 307 redirects too (#3514) (@tlimoncelli)
• fef79fb84d425d0af947637274bb85b979f3eab9: AUTODNS: enable concurrent gathering of zones (#3494) (@arnoschoon)
• eec0f4952f4c97ace92c85d88f5d735aeb711f6f: AUTODNS: fix error when restoring existing MX or SRV records (#3492) (@arnoschoon)
• 6bf1fda6d9a24051a00a50d6f012810abe88c8fc: INWX: Rewritten to use the modern diff2 system! (#3501) (@eliheady)
• e0e3021ca8c9906d512a2dd1e829a6283a692f79: INWX: use provisioned nameservers, fall back to hardcoded defaults (#3502) (@eliheady)

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

Best, Tom

Changelog

Provider-specific changes:

• 14c3acb8019e226be672c9862fc2d3cc3d36cc3a: CLOUDFLARE_API: SINGLE_REDIRECT permits more than 301/302 redirects (#3514) (@tlimoncelli)
• fef79fb84d425d0af947637274bb85b979f3eab9: AUTODNS: enable concurrent gathering of zones (#3494) (@arnoschoon)
• eec0f4952f4c97ace92c85d88f5d735aeb711f6f: AUTODNS: fix error when restoring existing MX or SRV records (#3492) (@arnoschoon)
• 0097b63a20a664b6aebf723b4860cae050afc1cb: CLOUDFLARE: CF_REDIRECT "name" should be 3-digits so it sorts better (#3495) (@tlimoncelli)
• 6bf1fda6d9a24051a00a50d6f012810abe88c8fc: INWX: move to diff2 for record corrections (#3501) (@eliheady)
• e0e3021ca8c9906d512a2dd1e829a6283a692f79: INWX: use provisioned nameservers, fall back to hardcoded defaults (#3502) (@eliheady)

Documentation:

• 5dafc9c1e3caaa4c3142e3009aa90db43f11c9ce: DOCS: Add fmt for .js files to releng process (#3490) (@tlimoncelli)
• 47abf996e0101564e52f33c403bca91cecb3bc70: DOCS: Added requested providers BookMyName, IPv64 and Spaceship (#3496) (@cafferata)
• 839d510b733c7db4bce848721a7bf40e085f391e: DOCS: Fix typo in IGNORE.md (#3512) (@gucci-on-fleek)
• 1e5acba8e34f26c1fab5b74aae0af60c204eb3c5: DOCS: language-reference/D: fix broken link (#3486) (@pataquets)
• 7661175d589327eb7327f0fece44a5f08e4e6e4f: META: typescript: Mark recursive parameter of require_glob optional (#3508) (@labrown)

CI/CD:

• 0d8dcea63a7e668886d0e0ea8ee02cdf78c15347: BUILD: Move regen steps to a script (#3491) (@tlimoncelli)
• 5d4f2869ad9125fd0731bad670bf0570d9ef42e8: Build(deps): Bump actions/cache from 4.2.2 to 4.2.3 (#3505) (@dependabot[bot])
• 9ff73df4527acf8a6de7d16b6f77eb10b14b8726: Build(deps): Bump actions/upload-artifact from 4.6.1 to 4.6.2 (#3506) (@dependabot[bot])
• 00c9c62321a3f1d3c708f98d4c62d20ef2299059: Build(deps): Bump github.com/golang-jwt/jwt/v5 from 5.2.1 to 5.2.2 (#3503) (@dependabot[bot])
• c5b3ccc7db899a73e8a4b67b0db413bc517c10c8: CICD: Detect broken HTML links in the documentation as part of the pipeline (#3439) (@cafferata)

Other changes and improvements:

• 5ad2df1076d7a4ab7982735da0f58f56b1ec38be: BUG: fix panic message (#3489) (@tlimoncelli)
• d5368053cf999f39b27021860893875b6c85cead: CHORE: Update dependencies (#3504) (@tlimoncelli)
• 587519e00837592b55cf16282ae3831071efcb6b: CHORE: Update dependencies (#3515) (@tlimoncelli)
• 475f99b8d58725cc50aa2292892888460cb600ad: bug(rev) D_EXTEND does not work with REV (#3488) (@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 https://github.com/StackExchange/dnscontrol/issues/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)

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