naps/powerdns repository overview

⁠PowerDNS Docker Container

• Small Alpine based Image
• MySQL (default), Postgres, SQLite and Bind backend included
• Automatic migration of database schema (for MySQL, Postgres and SQLite)
• DNSSEC support optional
• Automatic database initialization for MySQL, Postgres and SQLite
• Latest PowerDNS version (if not pls file an issue)
• Guardian process enabled
• Graceful shutdown using pdns_control

⁠Project history

This image is a (friendly) fork from psitrax/powerdns⁠ but adds several feature that were missing from the original project (see above for feature list) while multiple contributors were proposing code to implement them.

The kudos are going to the original project contributors. Feel free to bring your stone to the building by proposing PR to enhance this image.

⁠Usage

⁠MySQL

# Start a MySQL Container
$ docker run -d \
  --name pdns-mysql \
  -e MYSQL_ROOT_PASSWORD=supersecret \
  -v $PWD/mysql-data:/var/lib/mysql \
  mariadb:10.1

$ docker run --name pdns \
  --link pdns-mysql:mysql \
  -p 53:53 \
  -p 53:53/udp \
  -e AUTOCONF=mysql
  -e MYSQL_USER=root \
  -e MYSQL_PASS=supersecret \
  -e MYSQL_PORT=3306 \
  naps/powerdns \
    --cache-ttl=120 \
    --allow-axfr-ips=127.0.0.1,123.1.2.3

⁠Postgres

# Start a Postgres Container
$ docker run -d \
  --name pdns-postgres \
  -e POSTGRES_PASSWORD=supersecret \
  -v $PWD/postgres-data:/var/lib/postgresql \
  postgres:9.6

$ docker run --name pdns \
  --link pdns-postgres:postgres \
  -p 53:53 \
  -p 53:53/udp \
  -e AUTOCONF=postgres \
  -e PGSQL_USER=postgres \
  -e PGSQL_PASS=supersecret \
  naps/powerdns \
    --cache-ttl=120 \
    --allow-axfr-ips=127.0.0.1,123.1.2.3

⁠SQLite

$ docker run --name pdns \
  -p 53:53 \
  -p 53:53/udp \
  -e AUTOCONF=sqlite \
  naps/powerdns \
    --cache-ttl=120 \
    --allow-axfr-ips=127.0.0.1,123.1.2.3

⁠Configuration

Environment Configuration:

• MySQL connection settings
  • MYSQL_HOST=mysql
  • MYSQL_USER=root
  • MYSQL_PASS=root
  • MYSQL_DB=pdns
  • MYSQL_DNSSEC=no
• Postgres connection settings
  • PGSQL_HOST=mysql
  • PGSQL_USER=root
  • PGSQL_PASS=root
  • PGSQL_DB=pdns
• SQLite connection settings
  • SQLITE_DB=/pdns.sqlite3
• DNSSEC is disabled by default, to enable use DNSSEC=yes
• Want to disable database initialization? Use AUTOCONF=false
  • Want to disable automatic migration of database schema? Use AUTO_SCHEMA_MIGRATION=no
  • If this option is enabled afterwards on an existing installation, set INITIAL_DB_VERSION=x.y.z where x.y.z is the version of the schema currently installed on the database. This variable can be safely removed once the database has been upgraded for the first time.
• Want to apply 12Factor-Pattern? Apply environment variables of the form PDNS_$pdns-config-variable=$config-value, like PDNS_WEBSERVER=yes
• Want to use own config files? Mount a Volume to /etc/pdns/conf.d or simply overwrite /etc/pdns/pdns.conf
• Use TRACE=true to debug the pdns config directives

PowerDNS Configuration:

Append the PowerDNS setting to the command as shown in the example above. See docker run --rm naps/powerdns --help

⁠License

GNU General Public License v2.0⁠ applyies to PowerDNS and all files in this repository.

⁠Maintainer

• Antoine Millet [email protected]⁠

⁠Credits

• Christoph Wiechert [email protected]⁠: Original project maintainer
• Mathias Kaufmann [email protected]⁠: Reduced image size