tmuncks/pdns-recursor repository overview

⁠PowerDNS Recursor

The PowerDNS Recursor is a high-performance DNS recursor with built-in scripting capabilities. A full description⁠ can be found on the project website⁠.

⁠The Image

Docker image with PowerDNS Recursor.

⁠References

• Docker: https://hub.docker.com/r/tmuncks/pdns-recursor/⁠
• Github: https://github.com/tmuncks/docker-pdns-recursor/⁠

⁠Usage

⁠Environment variables

ENV variables can be used for configuration:

(name=value)

PDNS_allow_from=0.0.0.0/0
PDNS_dnssec=validate

The PowerDNS Recursor is configurable via env vars. Every variable starting with PDNS_ will be inserted into the default /etc/powerdns/recursor.conf config file in the following way:

• Prefix PDNS_ will be stripped
• Every _ will be replaced with -

Example from above config; PDNS_allow_from=0.0.0.0/0 will become allow-from=0.0.0.0/0 in /etc/powerdns/recursor.conf file. This way, you can configure PowerDNS Recursor any way you need, within a docker run command.

⁠Mounting configuration file

Another option is to mount a full PowerDNS Recursor configuration on /etc/powerdns/recursor.conf in the container. In this case, all PDNS_ environment variables will be ignored.

⁠Reference

You can find here⁠ all available settings.

⁠Examples

Recurser accepting queries from everywhere:

docker run -d -p 53:53 -p 53:53/udp --name pdns-recursor \
  --hostname ns1.example.com \
  -e PDNS_allow_from=0.0.0.0/0 \
  -e PDNS_dnssec=validate \
  tmuncks/pdns-recursor