This one module gives Caddy the ability to solve the ACME DNS challenge with over 75 DNS providers.
This module wraps DNS providers that are implemented by go-acme/lego which uses an old API that is no longer supported by Caddy. As such, this module is a temporary shim until a sufficient number of providers are ported to the new libdns interfaces.
You can use this module to get up and running quickly with your provider of choice, but instead of using this module long-term, please consider contributing to a libdns package for your provider instead.
The libdns implementations offer better performance, lighter dependencies, easier maintainability with growth, and more flexible configuration.
First, make sure Caddy is built with this module installed. This is easiest with xcaddy:
$ xcaddy build --with github.com/caddy-dns/lego-deprecated
Then find the documentation for your DNS provider.
Next, configure the ACME issuer in your Caddy JSON like so:
{
"module": "acme",
"challenges": {
"dns": {
"provider": {
"name": "lego_deprecated",
"provider_name": "<provider_code>"
}
}
}
}
and replace <provider_code> with the name of your provider, as given in the docs linked above.
Your provider's credentials and other settings are configured via environment variables, which are also described in the docs linked above.
You can also use this with the Caddyfile:
tls {
dns lego_deprecated <provider_code>
}
and replace <provider_code> with the name of your provider.
Unlike other modules in the caddy-dns repositories, this one can only be used in the ACME issuer module for solving the DNS challenge. Even though it shares the more general dns.providers namespace with other provider modules, using this module in any other place in your config will result in errors.