Runbooks¶

Procédures pas à pas. Toutes les commandes se lancent depuis /srv/docker.

Mettre à jour un service¶

docker compose pull <service> && docker compose up -d <service>
# ou tout : /home/jonathan/scripts/systeme/update.sh

HA a son script dédié avec rollback (update-homeassistant.sh).

Redémarrer une stack / un service¶

docker compose restart <service>
docker compose up -d <service>          # recrée si conf changée
docker compose logs -f <service>        # diagnostiquer
docker compose ps                       # état + santé

Rebuild d'une image maison¶

docker compose build <service> && docker compose up -d <service>
# ex: docker compose build wiki && docker compose up -d wiki

Ajouter un conteneur¶

Procédure complète (convention IP / .env / NPM / Authelia / monitoring) : Ajouter un conteneur.

Dépanner les pannes types¶

Symptôme	Piste
Service `unhealthy`	`docker compose logs -f <svc>` ; autoheal a-t-il bouclé ? ; healthcheck correct ?
Plus d'accès `*.tichnou.fr`	NPM up ? cert expiré ? « Force SSL » pendant renouvellement ? (voir Pièges)
RAID dégradé	`cat /proc/mdstat` ; `mdadm --detail /dev/md0` ; alerte HA reçue ?
Disque plein (`/` ~70 %)	`docker system df` ; `docker image prune` ; logs Loki/journald
HA ne démarre plus	verrou `…/.ha-update-hold` ? rollback auto effectué ?
Mail KO depuis un conteneur	DNS hairpin → utiliser `172.16.0.30` (Pièges)

Rollback global (migration compose)¶

docker compose down → restaurer depuis dockmate ou /mnt/hdd/backups → docker compose up -d. Voir Sauvegardes.