homelab:services:docuwiki
Table of Contents
DokuWiki
- Wat: Wiki-software (als container op de NAS, stack 50 in Portainer) om de configuratie van mijn homelab in bij te houden.
- Doel: Bijhouden wat er is geconfigureerd en geïnstalleerd, en waarom. De keuze staat in 26.001.
- GUI: de wiki
- Device: Synology DS423+
Afwijkende instellingen (met reden)
$conf['syntax'] = 'dw';inlocal.php. Reden: de persistente configmap mist deze verplichte instelling, zie Onderhoud en bekende problemen hieronder.phpmax 8.9inplugin.info.txtvan de Backlinks-plugin. Reden: een bekende bug markeert de plugin onterecht als incompatibel, zie hieronder.
Extensions
- TemplatePageName
- Doel: pagina’s aanmaken vanaf een template
- Gebruik: maak een pagina
c_templateaan binnen een namespace
- Catlist
- Doel: Genereren van inhoudsopgaven
- Gebruik:
<catlist -addPageButtonEach> -
- Disable page cache where catlist is used: enabled
- Show headline by default: disabled
- movepage
- Doel: Hernoemen en verplaatsen van pagina's
- Gebruik: Knop “Rename page” aan de zijkant van een pagina, of via hier
- Tag
- Doel: Gebruiken van tags (voor oa status en relevante onderwerpen)
- Gebruik:
- Afhankelijkheden: pagelist
- Pagelist
- Doel: nodig voor Tag Plugin
- Backlinks
- Doel: nodig voor backlinks, bijv. voor opsomming van alle services die op een device draaien
- Comments
- Doel: Voeg commentaar toe dat je alleen ziet bij het bewerken van pagina's
- Gebruik:
/* Zet hier je commentaar, nieuwe regel met \\ */
Resources
- CPU:
- RAM: gebruik in de praktijk ca. 35 MiB (momentopname
docker stats, 2026-10-18). Limiet:mem_limit: 256min de compose van stack 50 (Portainer), zodat een geheugenlek alleen deze container herstart en de NAS niet vertraagt. Zie 26.012 Limiteren RAM containers. - Storage:
Onderhoud en bekende problemen
Wiki crasht na update (parser TypeError)
- Symptoom: na een DokuWiki-update een fatale TypeError in de parser (ModeRegistry / parserutils.php); de wiki laadt niet meer.
- Oorzaak: de persistente configmap komt uit een oudere installatie en mist de instelling
syntax, die de nieuwe versie verplicht. - Oplossing: voeg toe aan
local.php:$conf['syntax'] = 'dw'; - Let op: de waarde is
dw(ofmdvoor Markdown). De oude waardendokuwikienmarkdownbestaan niet meer; metdokuwikiworden koppen en lijsten als platte tekst getoond.
Backlinks-plugin: onterechte PHP-compatibiliteitswaarschuwing
- Symptoom: de plugin wordt als incompatibel met de PHP-versie gemarkeerd.
- Oorzaak: bekende bug in de plugin:
phpmax 8.5wordt gelezen als “alle 8.5.x-versies uitgesloten” (GitHub: dokuwiki-plugin-backlinks, issue #57). - Workaround: zet in
plugin.info.txtvan de pluginphpmax 8.9. Bij een update van de plugin moet dit waarschijnlijk opnieuw.
Netwerk
- Segment:
(adres en VLAN: zie het ip-plan)
- Docker-netwerk: het standaardnetwerk van de stack. Poort 8181 (naar poort 80 in de container).
- Bereikbaar via de reverse proxy op
wiki.max.miels.nl.
Beveiliging
- Blootstelling: via de reverse proxy (
wiki.max.miels.nl, toegangsprofiellan, telefoons en werk) is de wiki leesbaar vanaf het werk en vanaf het IP van de mobiele provider. Zie de beveiligingsstandaard. Zie het risico in 26.001.
Backups
Zie de backupstandaard. Configuratie en data staan in /volume2/docker/dokuwiki (submappen config en data). De data staat op volume 2 en valt daarmee onder de NVMe-backup.
Beheer
- Updates: WUD-categorie B (image
latest, afkoeltijd 14d). Zie WUD.
Relaties
- Thema's:
/
homelab/services/docuwiki.txt · Last modified: by 127.0.0.1
