User Tools

Site Tools


homelab:services:docuwiki

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:services:docuwiki [2026/02/22 12:11] – [Extensions] Backlinks toegevoegd mielshomelab:services:docuwiki [2026/10/22 14:25] (current) – external edit 127.0.0.1
Line 1: Line 1:
 ====== DokuWiki ====== ====== DokuWiki ======
  
-  * **Wat**: Wiki-software om de configuratie van mijn homelab in bij te houden +  * **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 / geïnstalleerd, waarom en eventuele configuratie +  * **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]]. 
-  * **Link**: nvt+  * **GUI**: [[https://wiki.max.miels.nl/|de wiki]]
   * **Device**: [[homelab:devices:synology_ds423|Synology DS423+]]   * **Device**: [[homelab:devices:synology_ds423|Synology DS423+]]
-  * **[[resources:metadata:tags:status|Status]]**: {{tag>"wip"}} +  * **[[resources:metadata:tags:status|Status]]**: {{tag>concept}} 
-    * nog alle overige blokken invullen+ 
 +===== 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 ===== ===== Extensions =====
Line 45: Line 48:
      * [[https://www.dokuwiki.org/plugin:backlinks|Documentatie]]      * [[https://www.dokuwiki.org/plugin:backlinks|Documentatie]]
  
-===== Relaties ===== +  * Comments 
-  * Gerelateerde besluiten: +    * Doel: Voeg commentaar toe dat je alleen ziet bij het bewerken van pagina's 
-    * {{backlinks>.#homelab:besluiten}} +    * Gebruik: ''%%/* Zet hier je commentaar, nieuwe regel met \\ */%%'' 
-  * Gerelateerde services: +    * [[https://www.dokuwiki.org/plugin:comment|Documentatie]]
-    * {{backlinks>.#homelab:services}} +
-  * Gerelateerde infrastructuur: +
-    * {{backlinks>.#homelab:netwerk}} +
-  * Thema’s: +
-    * [[categorie:thema:bandbreedte]] +
-    * [[categorie:thema:container]] +
-    * [[categorie:thema:multi-user]] +
-    * [[categorie:thema:vpn]] +
-    * [[categorie:thema:firewall]] +
-    * [[categorie:thema:security]] +
-    * Aanvullingen mogen, voeg die toe aan [[i_template|de template]]+
  
-  
-====== Optionele blokken ====== 
-Verplaats relevante blokken naar boven deze kop, en verwijder uiteindelijk deze kop en alles er onder 
- 
-===== Netwerk ===== 
-  * VLAN: 
-  * Poorten: 
-  * Firewallregels: 
  
 ===== Resources ===== ===== Resources =====
   * CPU:   * CPU:
-  * RAM:+  * 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:   * 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 ===== ===== Beveiliging =====
-  * Authenticatie +  * 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]].
-  * exposure+
  
 ===== Backups ===== ===== Backups =====
-  * Wat +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.
-  * Hoe +
-  * Frequentie+
  
-===== Monitoring ===== +===== Beheer ===== 
-Wat wordt gemonitord+  * 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. */
  
-===== Afhankelijkheden ===== 
-  * Andere services / infra 
homelab/services/docuwiki.1771758707.txt.gz · Last modified: by miels