====== 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**: [[homelab:services:docuwiki|DokuWiki]], [[homelab:devices:synology_ds423|Synology DS423+]] * **[[resources:metadata:tags:status|Status]]**: {{tag>concept}} * **Thema's**: {{tag>container}} /* Beschikbare thematags (kies er 0 of meer, gescheiden met een spatie): backup bandbreedte container, vm dns, firewall, vpn guest, iot, lan, servers multi-user Uitleg en "Bij wijziging": resources:metadata:tags:thema Nieuwe tag? Maak een tagpagina en werk deze lijst bij in de templates voor services, devices en besluiten. */ ===== 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 [[homelab:services:docuwiki|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.