0. Überblick
- Verwendetes System: Debian 11 64 bit
- Genutzter User: Ich nehme alles als „root“ vor
- Testsystem: vServer XXL 2.0
- Zeitdauer: ca. 5 Minuten
- Schwierigkeit: Einfach. Nur Code kopieren 😉
- Besonderheiten:
- Grundlage ist folgende Anleitung: Traefik Reverseproxy installieren Diese Anleitung muss zuerst ausgeführt werden.
- Die Installation von Docker / Docker Compose wird hier vorausgesetzt.
1. DokuWiki installieren
1.1 Einleitung
DokuWiki (https://www.dokuwiki.org/dokuwiki) ist eine open source Software, welche es auf sehr einfache Art und Weise ermöglicht eigene Dokumentationen („wikis“) anzulegen. Die Software kommt komplett ohne Datenbank aus und ist daher sehr einfach zu pflegen.
1.2 Infos zu yml Dateien
Bei yml Dateien ist es sehr wichtig, dass die Zeilen alle richtig eingerückt sind. Die Zeilen MÜSSEN immer mit der Leertaste eingerückt werden. Es dürfen KEINE Tabs enthalten sein. Ihr könnt den nachfolgenden Code immer online „überprüfen“ lassen. Die meisten Fehler entstehen nämlich durch die falsche Formatierung. Ein Dienst zum Überprüfen ist zum Beispiel: https://codebeautify.org/yaml-validator
1.3 Vorbereitung
Diese Anleitung basiert auf dem aktuellen Debian 10 Betriebssystem. DokuWiki werden wir unter Docker realisieren. Dies ermöglicht uns später sehr schnelle Updates und eine schnelle Installation.
Um DokuWiki neben anderen Diensten auf unserem Server betreiben zu können, nutzen wir hier den Reverse Proxy Traefik. Die Anleitung dazu finden Sie hier: https://www.dogado.de/vps/vserver-anwendungsfaelle/traefik-reverseproxy-auf-vserver-installieren
1.3.1 Verzeichnis erstellen
Wir erstellen uns ein neues Verzeichnis, in welchem wir später alle Daten von DokuWiki abspeichen. Dazu geben wir folgendes in der Konsole ein:
mkdir -p /opt/containers/dokuwiki/config
Ihr könnt hier auch ein anderes Verzeichnis verwenden. Müsst dann aber die gesamte Anleitung entsprechend anpassen.
1.3.2 docker-compose.yml erstellen
Nun können wir mit der eigentlichen „Installation“ von DokuWiki beginnen. Dazu öffnet ihr folgende Datei:
nano /opt/containers/dokuwiki/docker-compose.yml
Nun kopiert ihr folgenden Code in die Datei. Dieser Code ist unser Bauplan für unseren DokuWiki Container.
version: "2.1"
services:
dokuwiki:
image: ghcr.io/linuxserver/dokuwiki
container_name: dokuwiki
environment:
- PUID=1000
- PGID=1000
- TZ=Europe/London
volumes:
- ./config:/config
restart: unless-stopped
networks:
- proxy
labels:
- "traefik.enable=true"
- "traefik.http.routers.dokuwiki.entrypoints=http"
- "traefik.http.routers.dokuwiki.rule=Host(wiki.euredomain.de)" # Hier eure URL eingeben #
- "traefik.http.middlewares.dokuwiki-https-redirect.redirectscheme.scheme=https"
- "traefik.http.routers.dokuwiki.middlewares=dokuwiki-https-redirect"
- "traefik.http.routers.dokuwiki-secure.entrypoints=https"
- "traefik.http.routers.dokuwiki-secure.rule=Host(wiki.euredomain.de)" # Hier eure URL eingeben #
- "traefik.http.routers.dokuwiki-secure.tls=true"
- "traefik.http.routers.dokuwiki-secure.tls.certresolver=http"
- "traefik.http.routers.dokuwiki-secure.service=dokuwiki"
- "traefik.http.services.dokuwiki.loadbalancer.server.port=80"
- "traefik.docker.network=proxy"
- "traefik.http.routers.dokuwiki-secure.middlewares=secHeaders@file"
networks:
proxy:
external: true
Nun müssen wir noch einiges anpassen.
1.3.3 Hostname anpassen
Nun müsst ihr noch den Hostnamen anpassen, über welchen später DokuWiki erreichbar sein soll.
Diese beiden Zeilen müsst ihr anpassen.
- "traefik.http.routers.dokuwiki.rule=Host(wiki.euredomain.de )"
- "traefik.http.routers.dokuwiki-secure.rule=Host(wiki.euredomain.de)"
In meinem Fall also:
- "traefik.http.routers.dokuwiki.rule=Host(wiki.testbereich.net)"
- "traefik.http.routers.dokuwiki-secure.rule=Host(wiki.testbereich.net)"
Wenn ihr DokuWiki direkt auf eurer „Hauptdomain“ betreiben wollt, dann ändert ihr es folgendermaßen ab:
"traefik.http.routers.dokuwiki.rule=Host(www.euredomain.de,euredomain.de)"
"traefik.http.routers.dokuwiki-secure.rule=Host(www.euredomain.de,euredomain.de)"
2. DokuWiki starten
Gebt nun folgendes ein, um euren DokuWiki Container zu starten:
docker compose -f /opt/containers/dokuwiki/docker-compose.yml up -d Nun geht ihr mit eurem Webbrowser auf eure Domain. Bei mir ist das https://wiki.testbereich.net.
Nun solltet ihr folgendes sehen. Mit einem Klick auf den Stift könnt ihr einen neuen Beitrag erstellen.
Hier könnt ihr nun Bilder, Texte und vieles mehr einfügen.
Nun steht euer neuer Text auf der Startseite.
