Pi-hole installeren op je NAS met Docker Compose
Pi-hole kan DNS-verzoeken van apparaten in je thuisnetwerk filteren. Op een NAS is Docker Compose een nette manier om Pi-hole te draaien, zolang je DNS en netwerk zorgvuldig instelt.
Voordat je begint
Zorg dat je NAS een vast IP-adres of DHCP-reservering heeft. Als het IP-adres van je DNS-server verandert, kunnen apparaten in huis ineens geen websites meer vinden.
1. Controleer of poort 53 vrij is
Pi-hole moet DNS aanbieden via TCP en UDP poort 53. Draait op je NAS al een DNS-server of andere dienst op poort 53, dan krijg je een conflict.
2. Maak een vaste projectmap
Maak bijvoorbeeld docker/pi-hole. Bewaar daarin je Compose-bestand en persistente Pi-hole-configuratie.
3. Gebruik de actuele officiële Compose-template
De officiële Pi-hole-documentatie raadt Docker Compose aan als eenvoudige start. De basis publiceert poort 53 TCP/UDP en webpoorten voor beheer. Pas de template aan op jouw NAS en netwerk.
4. Stel je tijdzone en beheertoegang in
Gebruik de juiste tijdzone en kies een sterk beheerderswachtwoord. Zet configuratiebestanden in persistente volumes zodat instellingen een containerupdate overleven.
5. Start het project
Maak in Container Manager een nieuw Project aan op basis van je Compose-bestand. Controleer de logs als de container direct stopt.
6. Test Pi-hole vóór je router wordt aangepast
Open eerst het beheeradres van Pi-hole en controleer of DNS-verzoeken werken. Stel nog niet meteen je hele thuisnetwerk om.
7. Stel daarna je router-DNS in
Laat je router via DHCP het IP-adres van Pi-hole als DNS-server uitdelen. Apparaten moeten daarna een nieuwe DHCP-lease krijgen of opnieuw verbinden.
8. Denk na over een tweede DNS-server
Een externe fallback zoals 8.8.8.8 naast Pi-hole klinkt veilig, maar clients kunnen die tweede DNS direct gebruiken en zo filtering omzeilen. Voor echte redundantie is een tweede lokale Pi-hole vaak logischer.
9. Gebruik Pi-hole niet meteen als DHCP-server
Dat kan prima, maar maakt de installatie complexer. Laat in het begin je router gewoon DHCP doen. Stap pas over als je daar een duidelijke reden voor hebt.
10. Update gecontroleerd
Bij Docker update je Pi-hole doorgaans door een nieuwe image op te halen en de container opnieuw te maken. Maak vooraf een back-up van je configuratie en gebruik de actuele release notes.
Veelvoorkomende fout: poort 53 is al bezet
Stop of herconfigureer de dienst die DNS al gebruikt. Pi-hole kan niet als netwerk-DNS functioneren als poort 53 op de host door een andere service wordt geclaimd.
Veelvoorkomende fout: internet lijkt weg
Test of Pi-hole zelf een upstream DNS-server bereikt en of clients werkelijk naar het juiste NAS-IP verwijzen. Als Pi-hole stopt en je netwerk maar één DNS-server kent, werkt naamomzetting niet meer.