diff --git a/README.md b/README.md index e961746..1d98249 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,15 @@ # PowerDNS Docker Images -This repository contains five Docker images - pdns-mysql, pdns-admin-static, pdns-admin-uwsgi, pdns-recursor and deprecated pdns-admin. Image **pdns-mysql** contains completely configurable [PowerDNS 4.x server](https://www.powerdns.com/) with mysql backend (without mysql server). Image **pdns-recursor** contains completely configurable [PowerDNS 4.x recursor](https://www.powerdns.com/). Images **pdns-admin-static** and **pdns-admin-uwsgi** contains fronted (nginx) and backend (uWSGI) for [PowerDNS Admin](https://git.0x97.io/0x97/powerdns-admin) web app, written in Flask, for managing PowerDNS servers. Pdns-admin is also completely configurable. Deprecated **pdns-admin** contains PowerDNS Admin in a single image where both nginx and uWSGI processes are managed by systemd. This image won't be updated anymore. +This repository contains five Docker images - pdns-mysql, pdns-recursor, pdns-admin-static, pdns-admin-uwsgi and deprecated pdns-admin. Image **pdns-mysql** contains completely configurable [PowerDNS 4.x server](https://www.powerdns.com/) with mysql backend (without mysql server). Image **pdns-recursor** contains completely configurable [PowerDNS 4.x recursor](https://www.powerdns.com/). Images **pdns-admin-static** and **pdns-admin-uwsgi** contains fronted (nginx) and backend (uWSGI) for [PowerDNS Admin](https://git.0x97.io/0x97/powerdns-admin) web app, written in Flask, for managing PowerDNS servers. Pdns-admin is also completely configurable. Deprecated **pdns-admin** contains PowerDNS Admin in a single image where both nginx and uWSGI processes are managed by systemd. This image won't be updated anymore. + +Most of the images (except *pdns-admin-static* based on `nginx` image) have now also the `alpine` tag thanks to the @PoppyPop . All images are available on Docker Hub: https://hub.docker.com/r/pschiffe/pdns-mysql/ +https://hub.docker.com/r/pschiffe/pdns-recursor/ + https://hub.docker.com/r/pschiffe/pdns-admin-uwsgi/ https://hub.docker.com/r/pschiffe/pdns-admin-static/ @@ -14,7 +18,9 @@ https://hub.docker.com/r/pschiffe/pdns-admin/ ## pdns-mysql -[![](https://images.microbadger.com/badges/image/pschiffe/pdns-mysql.svg)](http://microbadger.com/images/pschiffe/pdns-mysql "Get your own image badge on microbadger.com") +[![](https://images.microbadger.com/badges/version/pschiffe/pdns-mysql.svg)](https://microbadger.com/images/pschiffe/pdns-mysql "Get your own version badge on microbadger.com") [![](https://images.microbadger.com/badges/image/pschiffe/pdns-mysql.svg)](http://microbadger.com/images/pschiffe/pdns-mysql "Get your own image badge on microbadger.com") + +[![](https://images.microbadger.com/badges/version/pschiffe/pdns-mysql:alpine.svg)](https://microbadger.com/images/pschiffe/pdns-mysql:alpine "Get your own version badge on microbadger.com") [![](https://images.microbadger.com/badges/image/pschiffe/pdns-mysql:alpine.svg)](https://microbadger.com/images/pschiffe/pdns-mysql:alpine "Get your own image badge on microbadger.com") https://hub.docker.com/r/pschiffe/pdns-mysql/ @@ -34,6 +40,8 @@ PowerDNS server is configurable via env vars. Every variable starting with `PDNS There is also a `SUPERMASTER_IPS` env var supported, which can be used to configure supermasters for slave dns server. [Docs](https://doc.powerdns.com/md/authoritative/modes-of-operation/#supermaster-automatic-provisioning-of-slaves). Multiple ip addresses separated by space should work. +You can find [here](https://doc.powerdns.com/md/authoritative/) all available settings. + ### Examples Master server with API enabled and with one slave server configured: @@ -69,9 +77,36 @@ docker run -d -p 53:53 -p 53:53/udp --name pdns-slave \ pschiffe/pdns-mysql ``` +## pdns-recursor + +[![](https://images.microbadger.com/badges/version/pschiffe/pdns-recursor.svg)](https://microbadger.com/images/pschiffe/pdns-recursor "Get your own version badge on microbadger.com") [![](https://images.microbadger.com/badges/image/pschiffe/pdns-recursor.svg)](https://microbadger.com/images/pschiffe/pdns-recursor "Get your own image badge on microbadger.com") + +[![](https://images.microbadger.com/badges/version/pschiffe/pdns-recursor:alpine.svg)](https://microbadger.com/images/pschiffe/pdns-recursor:alpine "Get your own version badge on microbadger.com") [![](https://images.microbadger.com/badges/image/pschiffe/pdns-recursor:alpine.svg)](https://microbadger.com/images/pschiffe/pdns-recursor:alpine "Get your own image badge on microbadger.com") + +https://hub.docker.com/r/pschiffe/pdns-recursor/ + +Docker image with [PowerDNS 4.x recursor](https://www.powerdns.com/). + +PowerDNS recursor is configurable via env vars. Every variable starting with `PDNS_` will be inserted into `/etc/pdns/recursor.conf` conf file in the following way: prefix `PDNS_` will be stripped and every `_` will be replaced with `-`. For example, from above mysql config, `PDNS_gmysql_host=mysql` will became `gmysql-host=mysql` in `/etc/pdns/recursor.conf` file. This way, you can configure PowerDNS recursor any way you need within a `docker run` command. + +You can find [here](https://doc.powerdns.com/md/recursor/settings/) all available settings. + +### Examples + +Recursor server with API enabled: +``` +docker run -d -p 53:53 -p 53:53/udp --name pdns-recursor \ + -e PDNS_api=yes \ + -e PDNS_api_key=secret \ + -e PDNS_webserver=yes \ + -e PDNS_webserver_address=0.0.0.0 \ + -e PDNS_webserver_password=secret2 \ + pschiffe/pdns-recursor +``` + ## pdns-admin-uwsgi -[![](https://images.microbadger.com/badges/image/pschiffe/pdns-admin-uwsgi.svg)](https://microbadger.com/images/pschiffe/pdns-admin-uwsgi "Get your own image badge on microbadger.com") +[![](https://images.microbadger.com/badges/version/pschiffe/pdns-admin-uwsgi.svg)](https://microbadger.com/images/pschiffe/pdns-admin-uwsgi "Get your own version badge on microbadger.com") [![](https://images.microbadger.com/badges/image/pschiffe/pdns-admin-uwsgi.svg)](https://microbadger.com/images/pschiffe/pdns-admin-uwsgi "Get your own image badge on microbadger.com") https://hub.docker.com/r/pschiffe/pdns-admin-uwsgi/ @@ -132,7 +167,7 @@ docker run -d --name pdns-admin-uwsgi \ ## pdns-admin-static -[![](https://images.microbadger.com/badges/image/pschiffe/pdns-admin-static.svg)](https://microbadger.com/images/pschiffe/pdns-admin-static "Get your own image badge on microbadger.com") +[![](https://images.microbadger.com/badges/version/pschiffe/pdns-admin-static.svg)](https://microbadger.com/images/pschiffe/pdns-admin-static "Get your own version badge on microbadger.com") [![](https://images.microbadger.com/badges/image/pschiffe/pdns-admin-static.svg)](https://microbadger.com/images/pschiffe/pdns-admin-static "Get your own image badge on microbadger.com") https://hub.docker.com/r/pschiffe/pdns-admin-static/ @@ -146,34 +181,9 @@ docker run -d -p 8080:80 --name pdns-admin-static \ pschiffe/pdns-admin-static ``` -## pdns-recursor - -[![](https://images.microbadger.com/badges/image/pschiffe/pdns-recursor.svg)](http://microbadger.com/images/pschiffe/pdns-recursor "Get your own image badge on microbadger.com") - -https://hub.docker.com/r/pschiffe/pdns-recursor/ - -Docker image with [PowerDNS 4.x recursor](https://www.powerdns.com/). - -PowerDNS recursor is configurable via env vars. Every variable starting with `PDNS_` will be inserted into `/etc/pdns/recursor.conf` conf file in the following way: prefix `PDNS_` will be stripped and every `_` will be replaced with `-`. For example, from above mysql config, `PDNS_gmysql_host=mysql` will became `gmysql-host=mysql` in `/etc/pdns/recursor.conf` file. This way, you can configure PowerDNS recursor any way you need within a `docker run` command. - -You can find [here](https://doc.powerdns.com/md/recursor/settings/) all available settings. - -### Examples - -Recursor server with API enabled: -``` -docker run -d -p 53:53 -p 53:53/udp --name pdns-recursor \ - -e PDNS_api=yes \ - -e PDNS_api_key=secret \ - -e PDNS_webserver=yes \ - -e PDNS_webserver_address=0.0.0.0 \ - -e PDNS_webserver_password=secret2 \ - pschiffe/pdns-recursor -``` - ## pdns-admin - DEPRECATED -[![](https://images.microbadger.com/badges/image/pschiffe/pdns-admin.svg)](http://microbadger.com/images/pschiffe/pdns-admin "Get your own image badge on microbadger.com") +[![](https://images.microbadger.com/badges/version/pschiffe/pdns-admin.svg)](https://microbadger.com/images/pschiffe/pdns-admin "Get your own version badge on microbadger.com") [![](https://images.microbadger.com/badges/image/pschiffe/pdns-admin.svg)](http://microbadger.com/images/pschiffe/pdns-admin "Get your own image badge on microbadger.com") https://hub.docker.com/r/pschiffe/pdns-admin/