====== DokuWiki ====== * **Wat**: Wiki-software (als container op de NAS, stack 50 in [[homelab:services:portainer|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 [[homelab:besluiten:26.001-installatie_dokuwiki_incl_extensies|26.001]]. * **GUI**: [[https://wiki.max.miels.nl/|de wiki]] * **Device**: [[homelab:devices:synology_ds423|Synology DS423+]] * **[[resources:metadata:tags:status|Status]]**: {{tag>concept}} ===== 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 * [[https://wiki.max.miels.nl/doku.php?id=start&do=admin&page=config#plugin____templatepagename____plugin_settings_name|Configuratie]] * [[https://www.dokuwiki.org/plugin:templatepagename|Documentatie]] * Catlist * Doel: Genereren van inhoudsopgaven * Gebruik: ''%%%%'' * [[https://wiki.max.miels.nl/doku.php?id=start&do=admin&page=config#plugin____catlist____plugin_settings_name|Configuratie]] * Disable page cache where catlist is used: **enabled** * Show headline by default: **disabled** * [[https://www.dokuwiki.org/plugin:catlist|Documentatie]] * movepage * Doel: Hernoemen en verplaatsen van pagina's * Gebruik: Knop "Rename page" aan de zijkant van een pagina, of [[https://wiki.max.miels.nl/doku.php?id=homelab:home&do=admin&page=move_main|via hier]] * [[https://wiki.max.miels.nl/doku.php?id=start&do=admin&page=config#plugin____move____plugin_settings_name|Configuratie]] * Tag * Doel: Gebruiken van tags (voor oa status en relevante onderwerpen) * Gebruik: * [[https://wiki.max.miels.nl/doku.php?id=homelab:services:docuwiki&do=admin&page=config#plugin____tag____plugin_settings_name|Configuratie]] * [[https://www.dokuwiki.org/plugin:tag|Documentatie]] * Afhankelijkheden: pagelist * Pagelist * Doel: nodig voor Tag Plugin * [[https://wiki.max.miels.nl/doku.php?id=homelab:services:docuwiki&do=admin&page=config#plugin____pagelist____plugin_settings_name|Configuratie]] * [[https://www.dokuwiki.org/plugin:pagelist|Documentatie]] * Backlinks * Doel: nodig voor backlinks, bijv. voor opsomming van alle services die op een device draaien * [[https://www.dokuwiki.org/plugin:backlinks|Documentatie]] * Comments * Doel: Voeg commentaar toe dat je alleen ziet bij het bewerken van pagina's * Gebruik: ''%%/* Zet hier je commentaar, nieuwe regel met \\ */%%'' * [[https://www.dokuwiki.org/plugin:comment|Documentatie]] ===== 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 [[homelab:besluiten:26.012-limiteren_ram_containers|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. ==== Backlinks-plugin: onterechte PHP-compatibiliteitswaarschuwing ==== * **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: {{tag>lan}} (adres en VLAN: zie het [[homelab:standaarden:netwerk:ip-plan|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 [[homelab:standaarden:beveiliging|beveiligingsstandaard]]. Zie het risico in [[homelab:besluiten:26.001-installatie_dokuwiki_incl_extensies|26.001]]. ===== Backups ===== Zie de [[homelab:standaarden:backups|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 [[homelab:services:wud|WUD]]. ===== Relaties ===== * Besluiten: \\ {{backlinks>.#homelab:besluiten}} * Services: \\ {{backlinks>.#homelab:services}} * 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. */