Configuration for Pi-hole

README.md

@@ -1,2 +1,28 @@
-# tpl.docker-compose
+# Pi-hole deployment
 
+## Quick Start
+
+1. Copy `env.example` to `.env`
+
+2. Edit `.env` to adapt the Fully Qualified Domain Name (FQDN) of the Pi-hole
+   container.
+
+   This is used by Traefik to redirect requests to the web interface.
+
+3. `docker-compose up -d`
+
+4. Go to the Web interface at https://pi-hole.example.net, and adapt
+   the settings as needed for your setup.
+
+   For example:
+  
+   * **Settings** -> **DNS** -> **Upstream DNS Servers**:
+     Add at least one upstream server.
+  
+   * **Settings** -> **DNS** -> **Upstream DNS Servers**:
+     Enable **Use Conditional Forwarding** and configure it.
+   
+   * **Settings** -> **DHCP**:
+     Disable **DHCP server enabled** if you are using another DHCP server,
+     which is assumed in this repository.
+