/ Docker / Templates Docker / Pihole

Installer Pi-hole (Bloqueur de Pubs)

Pi-hole agit comme un serveur DNS qui bloque les publicités et les traqueurs sur tout votre réseau avant même qu'ils n'atteignent vos appareils. L'installation via Docker est recommandée pour garder votre système propre.

Persistance : Nous utilisons des volumes Docker pour que vos listes noires et vos statistiques soient conservées même si vous redémarrez le conteneur.
Sommaire

1. Le conflit du Port 53 (Ubuntu/Debian)

Pi-hole a besoin du port 53 pour répondre aux requêtes DNS. Or, sur Ubuntu et les Debian récents, ce port est déjà occupé par systemd-resolved.

Attention : Il faut libérer ce port avant de lancer Docker, sinon le conteneur refusera de démarrer.

Désactivez le résolveur système :

sudo systemctl disable --now systemd-resolved
sudo rm /etc/resolv.conf
echo "nameserver 1.1.1.1" | sudo tee /etc/resolv.conf

2. Créer le fichier Docker Compose

Créez un fichier docker-compose.yml dans un dossier dédié :

version: "3"

services:
  pihole:
    container_name: pihole
    image: pihole/pihole:latest
    ports:
      - "53:53/tcp"
      - "53:53/udp"
      - "80:80/tcp" # Interface Web
    environment:
      TZ: 'Europe/Paris'
      WEBPASSWORD: 'admin' # CHANGEZ CE MOT DE PASSE !
    volumes:
      - './etc-pihole:/etc/pihole'
      - './etc-dnsmasq.d:/etc/dnsmasq.d'
    restart: unless-stopped

3. Lancement

Démarrez le conteneur en mode détaché :

docker compose up -d

Accédez ensuite à l'interface d'administration :
http://IP-SERVEUR/admin

4. Utilisation (Configuration Clients)

Pour que les pubs soient bloquées, vos appareils doivent utiliser votre Pi-hole comme serveur DNS.

Méthode recommandée : Allez dans l'interface de votre Box Internet / Routeur (section DHCP ou DNS) et remplacez le DNS par défaut par l'Adresse IP de votre serveur Pi-hole.

Si vous ne pouvez pas modifier votre Box, configurez le DNS manuellement sur chaque appareil (PC, Smartphone) avec l'IP de votre serveur.