Documentation du homelab savethemall.eu

Cette documentation décrit le parc tel qu'il tourne : six hôtes Docker, environ trois cents conteneurs (relevé du 2026-10-06), un reverse proxy en deux étages et un annuaire d'identité qui garde les accès.

Ce que cette documentation est, et n'est pas

C'est la version relue et publiable de la connaissance du parc : ce qu'il faut savoir pour agir sans casser autre chose.

Ce n'est pas la mémoire de travail. Les rapports d'incident, les journaux de décision par stack et les FAQ vivent dans le vault Obsidian, et sont consultables sur le wiki. Une page publiée ici est une page que quelqu'un a jugée stable ; une note du vault est un état de la connaissance à un instant donné.

Le partage exact des rôles, et le test qui tranche en une phrase : Où écrire quoi.

Par où commencer

• Infrastructure

  Les hôtes, leurs adresses, ce qui tourne où, et où vivent les données.

• Stacks

  Les conventions Compose du parc et le cycle de vie d'un stack, de la création à la mise hors service.

• Réseau

  Le chemin d'une requête depuis Internet, la résolution DNS et son horizon dédoublé.

• Procédures

  Les gestes pas-à-pas : publier un service, patcher un hôte, lire un secret.

Les cinq faits qui évitent le plus d'erreurs

1. L'edge WAN est le NAS, pas vm-docker. Un filtrage L3 posé sur vm-docker ne bloque rien : la source qu'il voit est toujours nas. Voir Chaîne reverse proxy.
2. curl https://<fqdn> depuis le LAN ne teste pas le WAN. Le DNS est en horizon dédoublé. Voir DNS et résolution.
3. Dans le vault, 10-stacks/<nom>/compose.yml est un lien symbolique mort. Le fichier réel vit sur l'hôte. Voir Conventions.
4. Sur vm-docker et vm-compute-01, restart: on-failure:5 et non always. docker-staggered.service est la seule autorité de démarrage au boot.
5. Deux coffres : OpenBao pour les secrets machines, Vaultwarden pour les secrets humains. Vaultwarden est déjà déverrouillé : ne jamais lancer bw unlock. Voir Lire un secret du coffre.

Éditer cette documentation

Le contenu est écrit à la main dans docs/ du dépôt homelab-docs. La marche à suivre est dans le README.md du dépôt, et la mécanique dans Intégration continue.

Ce site n'a pas de fréquence de mise à jour

Il se reconstruit uniquement sur un push vers main : événementiel, jamais périodique. Aucun cron, aucun rebuild programmé.

C'est la différence avec le wiki (Wiki.js), resynchronisé chaque nuit parce qu'il dérive du vault — le vault bouge tout seul, donc le wiki doit repasser. Ici rien ne peut changer sans commit, et un rebuild horaire reconstruirait à l'identique.

Conséquence : modifier une note du vault ne met pas cette documentation à jour. Les deux ne sont pas reliés — voir le partage des rôles ci-dessous.

Dernière vérification de cette page : 2026-10-06