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/03/02 22:03] – [Extensions] comment 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 50: Line 53:
     * [[https://www.dokuwiki.org/plugin:comment|Documentatie]]     * [[https://www.dokuwiki.org/plugin:comment|Documentatie]]
  
- ===== Relaties ===== 
-/* Overzicht van hoe onderstaande kolommen gevuld (moeten) worden: 
- x = NVT 
- - = Wordt vanzelf gevuld dmv backlinks 
- V = Handmatig specificeren! 
- * = Hybride, kan gevuld worden met backlinks of harde links (bijv. services onder Portainer) 
  
- - Besluiten +===== Resources ===== 
- * Services  +  * CPU: 
- V Devices: +  * 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]]. 
- V Netwerk: firewall, vlan, dns-dhcp +  * Storage: 
- V Tags: bandbreedte container vpn multi-user backup vm + 
-   Gebruik van tags: {{tag>tag1 tag2}}+===== Onderhoud en bekende problemen =====
  
-Voeg aanvullingen mogen ook toe aan [[i_template|de template]] +==== Wiki crasht na update (parser TypeError) ====
-*/+
  
-^ [[homelab:besluiten:start|Besluiten]] ^ [[homelab:services:start|Services]] ^ [[homelab:devices:start|Devices]] ^ [[homelab:standaarden:netwerk:start|Netwerk]]  ^ [[resources:metadata:tags:start|Tags]]  ^ +  * **Symptoom**: na een DokuWiki-update een fatale TypeError in de parser (ModeRegistry / parserutils.php); de wiki laadt niet meer. 
-| {{backlinks>.#homelab:besluiten}}         |  [[portainer|Portainer]]  | [[..:devices:synology_ds423|NAS: Synology DS423+]]   |         | {{tag>container}}                                         ^+  * **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 ====
  
-====== Optionele blokken ====== +  * **Symptoom**: de plugin wordt als incompatibel met de PHP-versie gemarkeerd. 
-Verplaats relevante blokken naar boven deze kop, en verwijder uiteindelijk deze kop en alles er onder+  * **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 ===== ===== Netwerk =====
-  * VLAN: +  * Segment: {{tag>lan}} (adres en VLAN: zie het [[homelab:standaarden:netwerk:ip-plan|ip-plan]]) 
-  * Poorten: +  * Docker-netwerk: het standaardnetwerk van de stack. Poort 8181 (naar poort 80 in de container). 
-  * Firewallregels: +  * Bereikbaar via de reverse proxy op ''wiki.max.miels.nl''.
- +
-===== Resources ===== +
-  * CPU: +
-  * RAM: +
-  * Storage:+
  
 ===== 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+===== Beheer ===== 
 +  * Updates: WUD-categorie B (image ''latest'', afkoeltijd 14d). Zie [[homelab:services:wud|WUD]].
  
-===== Monitoring ===== +===== Relaties ===== 
-Wat wordt gemonitord+  * 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.1772485417.txt.gz · Last modified: by miels