homelab:besluiten:26.001-installatie_dokuwiki_incl_extensies

26.001 Installatie DokuWiki incl. extensies

/

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 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.

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