User Tools

Site Tools


homelab:services:docuwiki

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

Afwijkende instellingen (met reden)

  • $conf['syntax'] = 'dw'; in local.php. Reden: de persistente configmap mist deze verplichte instelling, zie Onderhoud en bekende problemen hieronder.
  • phpmax 8.9 in plugin.info.txt van 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_template aan 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
  • 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: 256m in 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 (of md voor Markdown). De oude waarden dokuwiki en markdown bestaan niet meer; met dokuwiki worden koppen en lijsten als platte tekst getoond.
  • Symptoom: de plugin wordt als incompatibel met de PHP-versie gemarkeerd.
  • Oorzaak: bekende bug in de plugin: phpmax 8.5 wordt gelezen als “alle 8.5.x-versies uitgesloten” (GitHub: dokuwiki-plugin-backlinks, issue #57).
  • Workaround: zet in plugin.info.txt van de plugin phpmax 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, toegangsprofiel lan, 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

homelab/services/docuwiki.txt · Last modified: by 127.0.0.1