A simple DNS hook that lets Dehydrated talk to the PowerDNS API.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Silke f21f489a42 Set Content-Type header in requests 1 year ago
tests Add test for soa_edit command 1 year ago
.gitignore Add default test config 1 year ago
.travis.yml Add Travis config 1 year ago
LICENSE.md Update licence to EUPL v1.2 2 years ago
README.md Update link to SOA-EDIT documentation 1 year ago
pdns_api.sh Set Content-Type header in requests 1 year ago
test.sh Add Travis config 1 year ago



Build Status

A simple DNS hook that lets Dehydrated talk to the PowerDNS API.



Add the settings for your PowerDNS API to Dehydrated’s config (in /etc/dehydrated or /usr/local/etc/dehydrated), or a config file next to pdns_api.sh:

PDNS_HOST=ns0.example.com # API Host. Can also be a URL, eg: http://ns0.example.com:8081
PDNS_PORT=8081            # Optional. Defaults to 8081
PDNS_KEY=secret           # API key
PDNS_SERVER=localhost     # Optional. Server for the API to use, usually `localhost`
PDNS_VERSION=1            # Optional. API version, 0 for anything under PowerDNS 4
PDNS_WAIT=300             # Optional. Delay for when slaves are slow
PDNS_ZONES_TXT=zones.txt  # Optional. File containing zones to use (see below).
PDNS_NO_NOTIFY=yes        # Optional. Disable sending a notification after updating the zone.
PDNS_SUFFIX=v.example.com # Optional. When using a dedicated validation zone via CNAME redirection

Configure the DNS hook by adding the following to your Dehydrated config:


Nested zones and subdomains are supported. These zones should be detected automatically, but can be overridden by creating a file called zones.txt in /etc/dehydrated, /usr/local/etc/dehydrated or next to pdns_api.sh with the zones:


These zones can be added in any order.

Incrementing the zone’s serial

PowerDNS can automatically increment the serial in the SOA record with the SOA-EDIT metadata entry. pdns_api.sh can show and edit this entry. Usage:

pdns_api.sh soa_edit <zone> [soa-edit] [soa-edit-api]