lego/docs/content/dns/zz_gen_pdns.md
Ludovic Fernandez 62fea05e21
Automatic generation of documentation (#818)
* generate a detailed CLI help
* generate a documentation site
* new readme
2019-03-08 19:47:06 +01:00

1.8 KiB

title date draft slug
PowerDNS 2019-03-03T16:39:46+01:00 false pdns

Configuration for PowerDNS.

  • Code: pdns

{{% notice note %}} Please contribute by adding a CLI example. {{% /notice %}}

Credentials

Environment Variable Name Description
PDNS_API_KEY API key
PDNS_API_URL API url

Additional Configuration

Environment Variable Name Description
PDNS_HTTP_TIMEOUT API request timeout
PDNS_POLLING_INTERVAL Time between DNS propagation check
PDNS_PROPAGATION_TIMEOUT Maximum waiting time for DNS propagation
PDNS_TTL The TTL of the TXT record used for the DNS challenge

Information

Tested and confirmed to work with PowerDNS authoritative server 3.4.8 and 4.0.1. Refer to PowerDNS documentation instructions on how to enable the built-in API interface.

PowerDNS Notes:

  • PowerDNS API does not currently support SSL, therefore you should take care to ensure that traffic between lego and the PowerDNS API is over a trusted network, VPN etc.
  • In order to have the SOA serial automatically increment each time the _acme-challenge record is added/modified via the API, set SOA-EDIT-API to INCEPTION-INCREMENT for the zone in the domainmetadata table

More information