Pi-hole

🟢 Pi-hole Übersicht

Pi-hole ist dein netzwerkweiter Werbeblocker und DNS-Server, der als Docker-Container auf deinem HomeLab läuft.

Allgemeine Infos

• **Server:** HomeServer2
• **Projektpfad:** /home/robin/docker/pihole
• **Docker-Container:** pihole
• **Image:** pihole/pihole:latest
• **WebGUI:** http://192.168.2.217:80 (oder via konfiguriertem Port)
• **Netzwerk:** gateway-net / host

Docker Setup

Parameter	Wert
Container Name	pihole
Image	pihole/pihole:latest
DNS Port	53/udp, 53/tcp
Web Interface Port	80/tcp
Restart Policy	unless-stopped

Wichtige Funktionen

• **DNS-Server:** Blockiert Werbung auf DNS-Ebene für alle Geräte im Netzwerk.
• **DHCP:** (Optional) Kann die IP-Adressvergabe im Netzwerk übernehmen.
• **Admin-Panel:** Verwaltung von Blacklists und Whitelists.

Logs

• • Standard Logs:**

docker logs pihole

• • Live-Analyse (DNS-Anfragen):**

docker logs -f pihole

• • Pi-hole Logdatei im Container:**

docker exec -it pihole tail -f /var/log/pihole/pihole.log

Wartung

Befehle zur Verwaltung und zum Update:

# Passwort für WebGUI vergessen? Neu setzen:
docker exec -it pihole pihole -a -p

# Adlists (Blocklisten) über die Konsole aktualisieren:
docker exec -it pihole pihole -g

# Container Update
docker compose pull && docker compose up -d

Backup relevante Daten

• **Teleporter:** Exportiere die Einstellungen über die Web-Oberfläche (Settings -> Teleporter).
• **Volumes:** Sichere den lokalen Ordner (meist `/etc/pihole` und `/etc/dnsmasq.d`), um Listen und Konfigurationen zu behalten.

Abhängigkeiten

• Port 53 darf auf dem Host nicht von `systemd-resolved` belegt sein.
• Statische IP des Servers (HomeServer2) im Router hinterlegt.

Probleme & Anleitungen

• DNS-Konfiguration – Wie man Pi-hole in der FritzBox oder im Router einträgt.
• Automatisches Git-Push-Skript für Docker-Compose – Backup der Docker-Konfiguration.
• Git befehle – Übersicht für manuelle Backups.

--- Zuletzt geprüft via `docker ps` am: 14.02.2026