StartAnleitungen

Pi-hole installieren: Werbeblocker fürs ganze Heimnetz einrichten

Pi-hole v6 Schritt für Schritt installieren: auf Raspberry Pi, Debian oder im Proxmox-Container, Router als DNS einstellen, Docker-Variante und Test.

Datum
Bearbeiter
Mark Klauser

Enthält Werbelinks, markiert mit *. Kaufst du darüber, erhalte ich eine Provision von Amazon. Der Preis bleibt für dich gleich, die Empfehlungen beeinflusst das nicht.

Kurz gesagt

Pi-hole braucht laut Dokumentation 512 MB RAM, 2 GB freien Speicher und eine feste IP-Adresse. Auf einem Debian-, Ubuntu- oder Raspberry-Pi-OS-System startest du die Installation mit curl -sSL https://install.pi-hole.net | bash und beantwortest ein paar Fragen. Danach trägst du die IP des Pi-hole im Router als DNS-Server ein, damit alle Geräte im Netz ihre Anfragen darüber schicken. Die Weboberfläche liegt unter http://IP-Adresse/admin.

Pi-hole blockiert Werbung und Tracker für alle Geräte im Heimnetz, auch für Fernseher, Konsolen und Smart-Home-Geräte, auf denen kein Werbeblocker läuft. Es arbeitet als DNS-Server: Fragt ein Gerät nach der Adresse einer Werbe-Domain, antwortet Pi-hole mit einer leeren Adresse, und die Werbung wird nicht geladen. Die Installation dauert etwa eine Viertelstunde. Diese Anleitung bezieht sich auf Pi-hole v6, Stand November 2026.

Was Pi-hole braucht

Laut Pi-hole-Dokumentation reichen 512 MB RAM und 2 GB freier Speicher, empfohlen sind 4 GB. Offiziell unterstützt werden Debian, Ubuntu, Raspberry Pi OS, Fedora, CentOS Stream, Alpine und Armbian, jeweils nur in Versionen, die noch gepflegt werden.

Pi-hole braucht eine feste IP-Adresse. Die Dokumentation erlaubt dafür auch eine DHCP-Reservierung im Router, das ist für Einsteiger der einfachste Weg.

Wo Pi-hole laufen kann:

  • Auf einem Raspberry Pi. Schon ein älteres Modell reicht, ein Pi 5 ist mehr als genug.
  • In einem LXC-Container unter Proxmox. Er braucht kaum Ressourcen und läuft auf dem Homeserver mit.
  • In einer Docker-Umgebung, z. B. auf einem NAS oder in einer Docker-VM.

Wichtig: Fällt das Gerät mit Pi-hole aus, funktioniert im ganzen Netz die Namensauflösung nicht mehr. Ein Server, der ohnehin dauerhaft läuft, ist deshalb der beste Platz.

Raspberry Pi 5 mit 4 GB (sparsam, für Pi-hole und weitere Dienste) bei Amazon ansehen

Schritt 1: System vorbereiten

Installiere auf dem Zielgerät eines der unterstützten Systeme, z. B. Raspberry Pi OS Lite oder Debian 13 ohne Desktop. Unter Proxmox legst du einen Container an:

  1. Unter local und „CT Templates“ die Vorlage für Debian 13 herunterladen.
  2. Mit „Create CT“ einen unprivilegierten Container anlegen: 1 Kern, 512 MB RAM, 8 GB Speicher.
  3. Im Reiter „Network“ eine statische IPv4-Adresse im Format 192.168.1.53/24 und das Gateway (die IP deines Routers) eintragen.
  4. Unter „Options“ „Start at boot“ aktivieren.

Wie Proxmox selbst installiert wird, steht unter Proxmox installieren.

Auf dem Raspberry Pi oder einer VM vergibst du stattdessen im Router eine feste Adresse für das Gerät. Danach das System aktualisieren:

sudo apt update
sudo apt full-upgrade

Im Proxmox-Container bist du bereits root, dort entfällt sudo.

Schritt 2: Pi-hole installieren

Pi-hole bietet einen Installationsbefehl in einer Zeile an:

curl -sSL https://install.pi-hole.net | bash

Wer das Skript vor dem Ausführen lesen will, lädt es zuerst herunter. Diesen Weg beschreibt die Dokumentation ebenfalls:

wget -O basic-install.sh https://install.pi-hole.net
sudo bash basic-install.sh

Der Installer fragt im Textmodus nach einigen Einstellungen. Navigiert wird mit Pfeiltasten, Leertaste und Enter:

  1. Die Netzwerkschnittstelle, über die Pi-hole erreichbar ist, meist eth0.
  2. Den Upstream-DNS-Server. Pi-hole leitet erlaubte Anfragen dorthin weiter. Zur Auswahl stehen mehrere öffentliche Anbieter.
  3. Ob eine Standard-Blockliste eingetragen werden soll. Für den Start ist „Ja“ richtig.
  4. Ob Anfragen protokolliert werden sollen und wie viel Pi-hole davon anzeigt. Wer andere Personen im Haushalt hat, wählt hier eine zurückhaltende Stufe.

Am Ende zeigt der Installer die Adresse der Weboberfläche und ein zufälliges Passwort an. Ein eigenes Passwort setzt du mit:

sudo pihole setpassword

Der frühere Befehl pihole -a -p aus Version 5 funktioniert in Version 6 nicht mehr.

Schritt 3: Weboberfläche öffnen

Im Browser rufst du auf:

http://192.168.1.53/admin

Statt 192.168.1.53 setzt du die IP-Adresse deines Pi-hole ein. Seit Version 6 bringt Pi-hole einen eigenen Webserver mit, lighttpd und PHP werden nicht mehr installiert. Belegt schon ein anderer Webserver die Ports 80 und 443, weicht Pi-hole laut Dokumentation auf 8080 und 8443 aus. Alle Einstellungen speichert Pi-hole in der Datei /etc/pihole/pihole.toml.

Schritt 4: Router auf Pi-hole umstellen

Bisher fragt noch kein Gerät bei Pi-hole nach. Damit das passiert, stellst du im Router ein, dass er per DHCP die Adresse des Pi-hole als DNS-Server an alle Geräte verteilt. Diesen Weg empfiehlt die Pi-hole-Dokumentation.

Bei einer Fritz!Box trägst du die IP-Adresse des Pi-hole in den IPv4-Einstellungen des Heimnetzes im Feld „Lokaler DNS-Server“ ein. Bei anderen Routern heißt die Einstellung meist DNS-Server im DHCP-Bereich.

Die Geräte übernehmen den neuen DNS-Server, wenn sie ihre IP-Adresse erneuern. Am schnellsten geht das, indem du WLAN oder Netzwerkkabel kurz trennst.

Verteilt dein Router über IPv6 auch einen eigenen DNS-Server, können Geräte an Pi-hole vorbei fragen. Prüfe in den IPv6-Einstellungen des Routers, welcher DNS-Server dort angekündigt wird.

Schritt 5: Testen

Auf einem Rechner im Netz fragst du Pi-hole direkt nach einer Adresse:

nslookup example.com 192.168.1.53

Kommt eine Antwort, arbeitet der DNS-Dienst. In der Weboberfläche siehst du im „Query Log“, welche Geräte Anfragen schicken und welche Domains blockiert wurden. Taucht ein Gerät dort nicht auf, nutzt es einen anderen DNS-Server, z. B. weil es fest eingestellt ist oder DNS über HTTPS verwendet.

Variante: Pi-hole mit Docker

Läuft bei dir schon Docker, z. B. in einer VM nach der Anleitung Docker auf Proxmox, kannst du Pi-hole als Container starten. Eine schlanke compose.yaml:

services:
  pihole:
    image: pihole/pihole:latest
    ports:
      - "53:53/tcp"
      - "53:53/udp"
      - "8080:80/tcp"
    environment:
      TZ: "Europe/Berlin"
      FTLCONF_webserver_api_password: "ein-sicheres-passwort"
    volumes:
      - ./etc-pihole:/etc/pihole
    restart: unless-stopped

Gestartet wird mit docker compose up -d, die Weboberfläche liegt dann unter Port 8080. Das Passwort setzt du in Version 6 über die Variable FTLCONF_webserver_api_password. Ältere Anleitungen nennen WEBPASSWORD, das gilt nur für Version 5. Auf einem Ubuntu-Host belegt der Dienst systemd-resolved oft schon Port 53, dann startet der Container nicht, bis du den Port freigibst.

Häufige Fragen

Welche Nachteile hat Pi-hole?

Manche Seiten und Apps funktionieren nicht mehr richtig, wenn eine Domain blockiert ist, die sie für mehr als Werbung brauchen. Solche Domains gibst du in der Weboberfläche frei. Werbung, die von derselben Domain kommt wie der Inhalt, z. B. bei YouTube, kann Pi-hole nicht filtern.

Welchen Upstream-DNS sollte ich nehmen?

Einen Anbieter, dem du vertraust. Der Installer bietet mehrere öffentliche Server an, du kannst die Auswahl später unter „Settings“ und „DNS“ ändern.

Kann Pi-hole auch DHCP übernehmen?

Ja, Pi-hole hat einen eingebauten DHCP-Server. Dann musst du DHCP im Router abschalten. Für die meisten Heimnetze ist es einfacher, den Router DHCP machen zu lassen und nur den DNS-Server umzustellen.

Wie aktualisiere ich Pi-hole?

Mit sudo pihole -up. Das Betriebssystem darunter aktualisierst du wie gewohnt mit apt. Im Docker-Container lädst du stattdessen ein neues Image und startest den Container neu.