PowerDNS setup

Enable the PowerDNS Authoritative HTTP API for use with PowerDNS Web UI.

PowerDNS Web UI uses the PowerDNS Authoritative HTTP API.

Add or update these settings in pdns.conf:

webserver=yes
webserver-port=8081
webserver-allow-from=127.0.0.1,::1
api=yes
api-key=replace-with-a-long-secret

Restart PowerDNS after changing the configuration.

​

Allow the web UI host

If PowerDNS Web UI runs on another host or in another container, include that address or network in webserver-allow-from.

Example for a Docker network:

webserver-allow-from=127.0.0.1,172.18.0.0/16

Keep this list narrow. The PowerDNS API is administrative.

​

Verify the API

From the machine running PowerDNS Web UI:

curl -H 'X-API-Key: replace-with-a-long-secret' \
  http://localhost:8081/api/v1/servers/localhost

If PowerDNS returns server information, configure the same URL and key in PowerDNS Web UI:

PDNS_API_URL=http://localhost:8081
PDNS_API_KEY=replace-with-a-long-secret
PDNS_SERVER_ID=localhost