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/01/06 15:16] – [Extensions] tag en pagelist toegevoegd mielshomelab:services:docuwiki [2026/10/22 14:25] (current) – external edit 127.0.0.1
Line 1: Line 1:
 ====== DokuWiki ====== ====== DokuWiki ======
  
-  * Documentatie van de DokuWiki die ik in mijn homelab heb geïnstalleerd +  * **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]]. 
 +  * **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 ===== ===== Extensions =====
Line 29: Line 36:
     * Gebruik:     * Gebruik:
     * [[https://wiki.max.miels.nl/doku.php?id=homelab:services:docuwiki&do=admin&page=config#plugin____tag____plugin_settings_name|Configuratie]]     * [[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]] +    * [[https://www.dokuwiki.org/plugin:tag|Documentatie]] 
-   * Afhankelijkheden: pagelist+    * Afhankelijkheden: pagelist
  
   * Pagelist   * Pagelist
Line 37: Line 44:
     * [[https://www.dokuwiki.org/plugin:pagelist|Documentatie]]     * [[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. */
  
homelab/services/docuwiki.1767709002.txt.gz · Last modified: by miels