{{tag>software sysadmin pi-hole docker}}

====== Pi-Hole: notes d'utilisation ======


La plupart des paramétrages peuvent être fait via l'interface web ou via le client en ligne de commande (CLI).


===== Mises à jour =====

via le CLI:

<code bash>
docker container exec -it pihole_container_name pihole -up
</code>


===== Gravity =====

Le script gravity est au cœur du fonctionnement de Pi-Hole. Il se charge de récupèrer les différentes listes de blocage publicitaire, d'intégrer la whitelist, la blacklist pour créer une liste unique utilisable par le service de DNS intégré. Il s'exécute hebdomadairement mais peut être lancé manuellement à tout moment.

<code bash>
docker container exec -it pihole_container_name pihole -g
</code>

===== Teleport =====

Permet de créer une sauvegarde dans le répertoire dans lequel il est invoqué. Cette sauvegarde peut ensuite être facilement restaurée via l'interface web

<code bash>
docker container exec -it pihole_container_name pihole -a -t
</code>

===== Les listes =====

==== format des listes ====

Les listes sont des URL vers des fichiers de type texte. Elles sont maintenues par des tiers qui les mettent à disposition. Le format attendu par **Pi-Hole** est le suivant:

<file txt>
# Commentaires et description
# License: GPLv3
# Contact: support [at] example [dot] com

domain.one.com
other.domain.io
another.example.com
</file>

Quelques sites proposant des listes:

  * https://fleuryk.kappatau.fr/pihole-blocklist/
  * https://justdomains.github.io/blocklists/
  * https://blocklistproject.github.io/Lists/

==== Ajouter une liste ====

Pour ajouter une liste:
  * **Group Management** > **Adlists**
  * copier l'URL de la liste (format pi-hole ou dnsmasq) et ajouter une commentaire.

Intégrer les nouveaux enregistrements de la liste en exécutant **Gravity**:
  * **Tools** > **Update Gravity**, cliquer sur **"Update"**.



===== Références =====

  * https://docs.pi-hole.net
  * https://lunarwatcher.github.io/posts/2020/05/17/what-i-learned-after-using-pihole-for-a-week.html