homelab:besluiten:26.001-installatie_dokuwiki_incl_extensies
Table of Contents
26.001 Installatie DokuWiki incl. extensies
- Wat: Keuze voor DokuWiki, met een aantal extensies, als wiki voor de documentatie van het homelab.
- Datum: 2026-01-04
- Betreft: DokuWiki, Synology DS423+
- Thema's:
/
Context
- 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
vlan1te 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.
Evaluatie
- Wanneer heroverwegen:
- Bij de verwachte migratie naar Obsidian.
homelab/besluiten/26.001-installatie_dokuwiki_incl_extensies.txt · Last modified: by 127.0.0.1
