DNScale DNS Authenticator plugin for certbot.
Automates Let's Encrypt DNS-01 challenges by creating and cleaning up TXT records via the DNScale API.
pip install certbot-dns-dnscaleOr install from source:
pip install git+https://github.com/dnscaleou/certbot-dns-dnscale.gitCreate an API key at dnscale.eu with the following scopes:
zones:readrecords:readrecords:write
Save it to a credentials file:
# /etc/letsencrypt/dnscale.ini
dns_dnscale_api_token = your-api-token-hereRestrict permissions:
chmod 600 /etc/letsencrypt/dnscale.inicertbot certonly \
--authenticator dns-dnscale \
--dns-dnscale-credentials /etc/letsencrypt/dnscale.ini \
-d example.com \
-d "*.example.com"certbot renewCertbot remembers the authenticator used for each certificate and will automatically use the DNScale plugin for renewal.
By default, the plugin waits 60 seconds for DNS propagation. Adjust if needed:
certbot certonly \
--authenticator dns-dnscale \
--dns-dnscale-credentials /etc/letsencrypt/dnscale.ini \
--dns-dnscale-propagation-seconds 120 \
-d example.comdocker run --rm \
-v /etc/letsencrypt:/etc/letsencrypt \
certbot/certbot \
pip install certbot-dns-dnscale && \
certbot certonly \
--authenticator dns-dnscale \
--dns-dnscale-credentials /etc/letsencrypt/dnscale.ini \
-d example.com| Option | Description | Default |
|---|---|---|
--dns-dnscale-credentials |
Path to credentials INI file | Required |
--dns-dnscale-propagation-seconds |
Seconds to wait for DNS propagation | 60 |
| Key | Description | Required |
|---|---|---|
dns_dnscale_api_token |
DNScale API token | Yes |
dns_dnscale_api_url |
API base URL | No (default: https://api.dnscale.eu) |
Apache License 2.0. See LICENSE.