Pi-Hole in Docker einrichten

Letztes Update 2026/01/10 21:56

© pihole.net

Portainer öffnen (https://<IP>:9443/), auf den Walfisch klicken und im Menü links Stacks anklicken. Auf + Add stack klicken. Im Feld Name pihole eingeben. Den untenstehendern Code kopieren und im Web editor einfügen.

services:
pihole:
container_name: pihole
image: pihole/pihole:latest
ports:
- '53:53/tcp'
- '53:53/udp'
- '80:80/tcp'
environment:
TZ: 'Europe/Vienna'
volumes:
- './etc-pihole:/etc/pihole'
- './etc-dnsmasq.d:/etc/dnsmasq.d'
cap_add:
- NET_ADMIN
restart: unless-stopped

Nach unten scrollen und Deploy stack anklicken. Im Menü Containers anklicken. Nach kurzer Zeit erscheint der Container als heathy. Somit läuft PiHole im Container.

Vor dem Start muss das Zugangspasswort entfernt oder gesetzt werden. In die Container Console wechseln

CC Attribution-Share Alike 4.0 CC Attribution-Share Alike 4.0

und hier

:# pihole setpassword
:# Enter New Password (Blank for no password):
:# [✓] Password Removed

oder alternativ mit Passwort

:# pihole setpassword
:# Enter New Password (Blank for no password):
:# Confirm Password:
:# [✓] New password set

eingeben.

Aufgerufen wird PiHole mit http://<IP>/admin/ und dem gesetzten oder gelöschten Passwortim Explorer.

Aktualisieren

Falls am unteren Rand des PiHole-Fensters eine Neue Version angezeigt wird

CC-BY-SA 4.0

dann sollte PiHole aktualisioert werden. Um PiHole im Docker Container zu aktualisiern, muss der Container mit einem aktuellen Image neu erstellt werden. pihole -up funktioniert innerhalb eines Containers nicht.

In der Container list den Container pihole anklicken und in den nun aufscheinenden Container details auf den Button Recreate klicken. Im folgenden Fenster Re-pull image aktivieren und auf Recreate klicken.

CC-BY-SA 4.0

Die eingetragenen Daten werden nicht geändert, mit Ausnahme der DNS Settings. Diese müssen neu eingestellt werden. Am besten vor dem Update notieren.

Weiter Information auf Github

Dieses Dokument als PDF