DokuWiki ist eine standardkonforme, einfach zu verwendende und zugleich äußerst vielseitige Open Source Wiki-Software. Die Anwendung nutzt einfache Textdateien zur Speicherung der Inhalte und benötigt insofern keine Datenbank. Der integrierte Konfigurations-Manager erlaubt es, Einstellungen direkt über eine Anwenderfreundliche Web-Oberfläche vorzunehmen. (Eigenbeschreibung des Projektes)

Durch die Ablage der Konfiguration und der Inhalte im Dateisystem werden das Backup, manuelle Eingriffe sowie auch eine Migration bzw. eine Replikation auf andere Instanzen deutlich erleichtert.

Der Verzicht auf eine Datenbank reduziert auch die Anforderungen an die verfügbaren Systenressourcen.

Der Container wird wie folgt mit docker run eingerichtet und gestartet:

docker run -d \ 
  --name=dokuwiki \
  -e PUID=2000 \
  -e PGID=2000 \
  -e TZ=Europe/London \
  -p 80:80 \
  -p 443:443 \
  -v /path/to/appdata/config:/config \
  --restart unless-stopped \
  linuxserver/dokuwiki

Dies sind die wichtigsten Parameter. Sofern sie mit einem „*“ markiert sind, sollte eine Anpassung erfolgen:

In der Konfiguration werden Volumes in der Regel im folgenden Format angegeben:

<Pfad auf dem Host>:<Pfad im Container>[:<Optionen>]

Die Volumes haben die folgenden Funktionen (maßgeblich ist der Pfad im Container):

Der Container wird wie folgt in der docker-compose.yml konfiguriert:

docker-compose-yml

version: "2.1"
services:
  dokuwiki:
    image: linuxserver/dokuwiki
    container_name: dokuwiki
    environment:
      - PUID=2000
      - PGID=2000
      - TZ=Europe/Berlin
    volumes:
      - /path/to/config:/config
    ports:
      - 80:80
      - 443:443
    restart: unless-stopped

Der Container kann mit den folgenden Eintragungen in der docker-compose.yml in Træfik integriert werden:

 
...

  dokuwiki:
    image: linuxserver/dokuwiki
    container_name: dokuwiki
    environment:
      - PUID=2000
      - PGID=2000
      - TZ=Europe/Berlin
    volumes:
      - /path/to/config:/config
    restart: unless-stopped
    labels:
     - traefik.http.routers.dokuwiki.rule=Host(`wiki.example.com`)
     - "traefik.http.routers.dokuwiki.tls.certResolver=default"
     - "traefik.http.routers.dokuwiki.tls=true"

Beim Update des Images ist Vorsicht geboten. Sofern sich die DokuWiki-Version im Image ändert, kann dies zu einem nicht mehr lauffähigen System führen.Die notwendige Migration der persistierten Daten, die sonst anlässlich des Upgrades von DokuWiki durchgeführt wird, ist in diesem Fall nicht erfolgt, und die Daten passen daher u.U. nicht zur neuen DokuWiki-Version.

Die folgenden Vorgehensweise ist empfehlenswert:

1. Version des Images in der Produktionsumgebung durch Vorgabe des entsprechenden Tags pinnen.
2. Bei Verfügbarkeit einer neuen Version des Images diese zunächst in einer getrennten Testinstanz mit den produktiven Daten testen.
3. Sofern das Testsystem mit der neuen Images-Version nicht mehr lauffähig ist, Roll-Back der Testinstanz auf die bisherige Version vornehmen und das DokuWiki mit „Bordmitteln“ (z.B. mit dem upgrade Plugin) im laufenden Container updaten (ggf. ist es notwendig vorab die produktiven Daten neu vom Produktionssystem abzuziehen und erneut einzuspielen).
4. Danach erneut neue Image-Version in die Testversion einspielen und testen.
5. Entsprechend den Ergebnissen aus den Punkten 2-4 das Update der Produktionsumgebung vornehmen und dabei die Version des Images auf die neue Version pinnen.