User Tools

Site Tools


homelab:services:pi-hole

Pi-hole

Afwijkende instellingen (met reden)

  • Webinterface op poort 9090 in plaats van 8080. Reden: 8080 was al in gebruik.
  • Settings → All settings → NTP (Network Time Sync): ntp.ipv4.active en ntp.ipv6.active uitgeschakeld. Reden: in de logs van de container stond dat de NTP-servers niet gevonden werden (dit staat ook in de handleiding waarop de installatie is gebaseerd).
  • Extra blocklists toegevoegd. Reden: clients vragen Pi-hole rechtstreeks, waardoor de adblock van de router niet meer meedoet.
  • De upstream-DNS is niet naar de router gestuurd, zodat Pi-hole zelf de adblocking doet.
  • De DHCP-instellingen van de router (optie 6) staan in de DNS- en DHCP-standaard.
  • De NAS heeft een tweede adres in iot: 192.168.3.9 (DHCP-reservering max-iot in de router, bewust zonder gateway). Reden: IoT-apparaten praten zo rechtstreeks met Pi-hole in hun eigen subnet, zonder routering of NAT. Zonder dit zag Pi-hole al het verkeer uit iot als router.lan. In Pi-hole zelf is niets aangepast: het luistert al op alle interfaces (network_mode: host en FTLCONF_dns_listeningMode: all). Zie 26.013.
  • Containers op de NAS gebruiken Pi-hole rechtstreeks (dns: 192.168.1.10 in hun compose) en staan in de Query Log met hun eigen Docker-adres, te filteren op Client (by IP). Zie 26.014 en de standaard voor containers.
  • guest (en waarschijnlijk WireGuard) verschijnt in Pi-hole als router.lan: dat verkeer loopt via de firewallzone lan met NAT. Bewust zo gelaten, zie 26.013.

Netwerk

  • Segment:
    ,

    (adressen en VLAN's: zie het ip-plan). Pi-hole is bereikbaar op 192.168.1.10 (lan) en op 192.168.3.9 (iot, de tweede aansluiting van de NAS). De NAS zelf gebruikt 8.8.8.8 en 8.8.4.4 als DNS, zie de DNS- en DHCP-standaard.

  • Netwerkmodus: host (geen eigen Docker-bridge): Pi-hole luistert direct op het adres van de NAS.
  • Poorten: 53 (DNS) en 9090 (webinterface, ingesteld met FTLCONF_webserver_port).
  • Extra rechten voor de container: SYS_TIME en SYS_NICE.
  • Firewallregel “DNS op Max-container-PiHole”: DNS naar 192.168.1.10 poort 53 vanuit elk segment.

Resources

  • CPU: geen limiet
  • RAM: gebruik ca. 65 MiB (momentopname docker stats, 2026-10-18), geen limiet. Zie 26.012.

Opslag

  • Configuratie: /volume2/docker/pihole (submappen pihole en dnsmasq.d)

Backups

Zie de backupstandaard.

Beheer

  • Updates: WUD-categorie C, alleen melden. Zie WUD. Een herstart van de container of de NAS laat iot en guest zonder DNS, zie de noodprocedure hieronder.
  • Beheer van de container via Portainer.
  • Bron voor de installatie: de handleiding van Marius Hosting.

Als Pi-hole uitvalt: DNS voor iot en guest herstellen

Wanneer: Pi-hole is niet bereikbaar (container gestopt of NAS uit, te zien in Portainer) en apparaten in iot en guest hebben geen DNS. lan hoeft niets: dat heeft de router als tweede DNS, wel kan het even trager zijn. Keuze en afwegingen: 26.013.

Alles gebeurt in LuCI. Open het via het IP-adres, dat heeft geen DNS nodig.

  1. Network → Interfaces → IoT → Edit → DHCP Server → Advanced Settings → DHCP-Options: vervang 6,192.168.3.9 door 6,192.168.3.1 (de router in iot). Geen spatie voor de 6.
  2. Network → Interfaces → guest → Edit → DHCP Server → Advanced Settings → DHCP-Options: vervang 6,192.168.1.10 door 6,192.168.4.1 (de router in guest).
  3. Voor snel effect: zet bij beide interfaces onder DHCP Server → General Setup de Lease time op 5m. Anders pakken apparaten de wijziging pas na ongeveer de helft van de leasetijd (nu 12 uur) op.
  4. Klik per interface op Save en daarna op de pagina op Save & Apply.
  5. Apparaten pakken het nieuwe DNS-adres bij hun volgende vernieuwing van het adres. Versnellen kan door Wi-Fi uit en aan te zetten of het apparaat te herstarten (bij slimme apparaten: stroom eraf).

De router lost dan zelf op via de WAN-DNS (8.8.8.8 en 8.8.4.4): alles werkt weer, maar zonder blokkering en zonder inzicht in Pi-hole.

Terugzetten als Pi-hole weer werkt

  1. iot: optie terug naar 6,192.168.3.9. guest: optie terug naar 6,192.168.1.10.
  2. Lease time van beide terug op 12h.
  3. Save & Apply. Apparaten die nu de router gebruiken, komen bij hun volgende vernieuwing terug bij Pi-hole (versnellen zoals hierboven).

Relaties

homelab/services/pi-hole.txt · Last modified: by 127.0.0.1