Behoefte aan consistente documentatie van een steeds complexer homelab.
Snel en eenvoudig nieuwe pagina's kunnen aanmaken volgens een vast format.
Overzicht behouden bij groei van het homelab.
Opties
Gekozen: DokuWiki met extensies: ondersteunt templates, een eigen startpagina per namespace, links naar nog niet bestaande pagina's, en backlinks en tags.
Afgewezen: Wiki.js: eerst geprobeerd, maar:
Ondersteunt geen templates (steeds handmatig copy-pasten).
De navigatie voelt onnatuurlijk: binnen een namespace kan je geen standaard landingspagina maken waarop de toepassing van die namespace wordt toegelicht.
Je kan geen links maken naar nog niet bestaande pagina's (om bijvoorbeeld binnen een item vlan1 te noemen, zodat je later die pagina aanmaakt en kan zien waar backlinks vandaan komen).
Een pagina met backlinks of een lijst van alle pagina's met een bepaalde tag is er niet of lastig te maken.
Besluit
DokuWiki draait als Docker-container op de NAS, met extensies voor templates, inhoudsopgaven, verplaatsen, tags, backlinks en commentaar. De extensies en hun instellingen staan op de DokuWiki-pagina.
Gevolgen
Technisch:
Bereikbaar via een reverse proxy: van thuis, van het werk en via het IP van de mobiele provider.
Operationeel:
De container wordt via WUD bijgewerkt; het risico op breaking changes is laag.
De data staat op volume 2 en valt daarmee onder de NVMe-backup.
Risico's:
Iedereen op het werk of bij dezelfde provider heeft read-toegang tot de wiki.