From 699cd358775f4037e1d720486971c75b222f4944 Mon Sep 17 00:00:00 2001
From: Pim van den Berg <pim@nethuis.nl>
Date: Tue, 21 Jun 2022 15:00:58 +0200
Subject: [PATCH] add README.md

---
 README.md | 55 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 55 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d328dd4
--- /dev/null
+++ b/README.md
@@ -0,0 +1,55 @@
+# PowerDNS Docker container
+
+* Debian slim based image
+* PowerDNS package from Debian
+* Bind backend support only
+
+# Usage
+
+```
+$ mkdir zones
+$ cat > zones/example.tld <<EOT
+\$TTL    3600
+@       IN      SOA     ns1.example.tld. hostmaster.example.tld. (
+                        2022010101      ; Serial
+                        8H              ; Refresh
+                        1H              ; Retry
+                        1W              ; Expire
+                        1H )            ; Negative Cache TTL
+
+                NS      ns1.example.tld.
+
+                A       192.0.2.1
+                AAAA    2001:db8::1
+EOT
+$ cat > named.conf <<EOT
+zone "example.tld" { type master; file "/var/lib/powerdns/zones/example.tld"; allow-query { any; }; };
+EOT
+
+$ docker run -it \
+    --name powerdns \
+    -v $(pwd)/named.conf:/etc/powerdns/named.conf \
+    -v $(pwd)/zones/:/var/lib/powerdns/zones/ \
+    -p 5353:53/udp -p 5353:53 \
+    pommib/powerdns:4.4-bullseye
+
+$ dig +short @127.0.0.1 -p5353 example.tld A
+192.0.2.1
+```
+
+# docker-compose
+
+```
+version: "3"
+
+services:
+  powerdns:
+    container_name: powerdns
+    image: pommib/powerdns:4.4-bullseye
+    ports:
+      - "5353:53/tcp"
+      - "5353:53/udp"
+    volumes:
+      - '${PWD}/named.conf:/etc/powerdns/named.conf'
+      - '${PWD}/zones/:/var/lib/powerdns/zones/'
+```