Documentatie van homelab savethemall.eu

Machinevertaling van het Franse origineel.

Deze documentatie beschrijft het systeem zoals het is: zes Docker-hosts, ongeveer driehonderd containers (standnummer 2026-10-06), een reverse proxy in twee stappen en een identiteitsdirectory die de toegang beheert.

Wat deze documentatie is, en niet is

Dit is de versie die kan worden gelezen en gepubliceerd van de kennis over het systeem: wat je moet weten om zonder andere systemen te beschadigen te handelen.

Dit is geen werkgeheugen. Incidentrapporten, beslissingslogboeken per stack en de FAQ bevinden zich in de Obsidian-vault, en zijn te raadplegen op de wiki. Een pagina die hier is gepubliceerd, is een pagina die als stabiel is beschouwd; een notitie uit de vault is een staat van de kennis op een bepaald moment.

De exacte verdeling van rollen, en de test die in één zin wordt weergegeven: Waar schrijven we wat.

Waar begin ik

• Infrastructuur

  De hosts, hun adressen, wat er draait, en waar de data zich bevindt.

• Stacks

  De Compose-conventies van het systeem en het levenscyclus van een stack, van creatie tot uitfasen.

• Netwerk

  De route van een verzoek vanaf het internet, DNS-resolutie en de dubbele horizon.

• Procedures

  De stapsgewijze handelingen: een service publiceren, een host patchen, een geheime code lezen.

De vijf feiten die de meeste fouten voorkomen

1. De WAN-kant is het NAS, niet vm-docker. Een L3-filter op vm-docker blokkeert niets: de bron die het ziet is altijd nas. Zie Omgekeerde proxy.
2. curl https://<fqdn> vanaf het LAN test de WAN niet. Het DNS is in een dubbele zone. Zie DNS en resolutie.
3. In de vault, is 10-stacks/<nom>/compose.yml een dode symbolische link. Het daadwerkelijke bestand bevindt zich op de host. Zie Conventies.
4. Op vm-docker en vm-compute-01, is restart: on-failure:5 en niet always. docker-staggered.service is de enige autoriteit tijdens het opstarten.
5. Twee dozen: OpenBao voor machine-geheimen, Vaultwarden voor menselijke geheimen. Vaultwarden is al geopend: nooit bw unlock starten. Zie Een geheim uit de doos lezen.

Deze documentatie bewerken

De inhoud is handmatig geschreven in docs/ van de repository homelab-docs. De stappen om te volgen staan in README.md van de repository, en de mechanica in Continue integratie.

Deze site heeft geen updatefrequentie

Het wordt alleen hergebouwd bij een push naar main: incidenteel, nooit periodiek. Geen cron, geen geplande rebuild.

Dit is het verschil met het wiki (Wiki.js), dat elke nacht wordt gesynchroniseerd omdat het afkomstig is van de vault — de vault beweegt zichzelf, dus moet het wiki ook opnieuw synchroniseren. Hier kan niets veranderen zonder commit, en een periodieke rebuild zou het exact opnieuw bouwen.

Gevolg: het aanpassen van een notitie in de vault, houdt deze documentatie niet bij. Ze zijn niet met elkaar verbonden — zie de rollenverdeling hieronder.

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