User Tools

Site Tools


homelab:besluiten:26.001-installatie_dokuwiki_incl_extensies

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
homelab:besluiten:26.001-installatie_dokuwiki_incl_extensies [2026/10/20 15:41] – removed - external edit (Unknown date) 127.0.0.1homelab:besluiten:26.001-installatie_dokuwiki_incl_extensies [2026/10/20 18:09] (current) – external edit 127.0.0.1
Line 1: Line 1:
 +====== 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.