Letztes Update 2026/06/25 22:41

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 the 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

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.

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

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.

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

Nach der Installation läuft Pi-Hole automatisch auf dem Raspberry Pi. Damit nun Werbung gefiltert werden kann, muss am Windows- oder Linux-Rechner der RPi als DNS-Server eingetragen werden.

• Systemsteuerung / Netzwerkadapter aufrufen.

• Die Eigenschaften / dann Internetprotokoll v4 aufrufen

• Die IP-Adresse des Servers, auf dem PiHole installiert ist, in den DNS-Einstellungen eintragen.

Um einen oder mehrere DNS-Server einzutragen, kann nmtui verwendeet werden.

sudo su
nmtui

Edit a connection auswählen.

Wired connection 1 und Edit auswählen. Als Ethernetanschluß kann aber auch jeder andere Name (z.B. eth0, …) eingetragen sein.

Hier kann der oder können die DNS Server eingetragen werden. Die Daten mit OK sichern und aus dem Programm aussteigen. Mit exit als root aussteigen.

Alternativ die Netzadresse manuell eingeben. Siehe hier.

Weiter Information auf Github