DockNS

Appearance

PowerDNS Configuration ​

HEAD'S UP

If you haven't read the primer on name server configuration, you should read that first as this page builds on the information presented there.

What is PowerDNS? ​

PowerDNS is a suite of products designed for large-scale DNS deployments. DockNS works specifically with the PowerDNS Authoritative Server, which is specifically designed for answering only authoritative DNS questions.

PowerDNS Setup ​

See the PowerDNS docs for instructions on enabling the API and creating a key.

Fields ​

host string required ​

The host field is the URL at which to connect to your PowerDNS instance's webserver. The protocol (http:// or https://) must be included as well as the port the webserver is running on.

Example:

toml
[name_servers.powerdns_server]
service = "powerdns"
host = "http://192.168.1.64:8081"
api_key = "mysecureapikey"
bash
DOCKNS_NS_POWERDNS_SERVER_SERVICE=powerdns
DOCKNS_NS_POWERDNS_SERVER_HOST=http://192.168.1.64:8081
DOCKNS_NS_POWERDNS_SERVER_API_KEY=mysecureapikey

api_key string required ​

The api_key field is configured in PowerDNS using the api-key field. The content of that field should be used as the api_key for DockNS.

Example:

toml
[name_servers.powerdns_server]
service = "powerdns"
api_key = "mysecureapikey"
bash
DOCKNS_NS_POWERDNS_SERVER_API_KEY=mysecureapikey
conf
api=yes
api-key=mysecureapikey