Lektion 4 – DokuWiki installieren & konfigurieren

Ziel dieser Lektion: Du installierst DokuWiki im Standard-Webverzeichnis von Apache und richtest es vollständig im Browser ein.

Schritt 1 – DokuWiki herunterladen

Lade dir DokuWiki auf deinem Hauptrechner herunter:

Besuche: https://download.dokuwiki.org

Wähle die aktuelle Stable-Version (.tgz)

Entpacke die Datei → z. B. in `dokuwiki-20xx-xx-xx/`

Schritt 2 – Dateien mit FileZilla übertragen

Verbinde dich per SFTP mit dem Raspberry Pi:

Einstellung	Wert
Protokoll	SFTP
Host	raspberrypi.local
Benutzername	pi
Passwort	(dein gesetztes Passwort)
Port	22

→ Navigiere auf dem Raspberry Pi zu: `/var/www/html` → Lösche ggf. vorhandene Dateien wie `index.html` → Ziehe den Inhalt des entpackten DokuWiki-Ordners in dieses Verzeichnis

Schritt 3 – Dateiberechtigungen korrekt setzen

Damit Apache DokuWiki ausführen kann und du gleichzeitig mit FileZilla Dateien löschen oder bearbeiten kannst, müssen die Dateirechte korrekt gesetzt werden:

sudo chown -R pi:www-data /var/www/html sudo chmod -R 775 /var/www/html

→ Damit gehört das Webverzeichnis dem Benutzer `pi`, der es bearbeiten darf → Die Gruppe `www-data` erlaubt Apache, auf das Wiki zuzugreifen

Schritt 4 – DokuWiki im Browser installieren

Öffne auf deinem Hauptrechner den Browser und gib ein:

http://raspberrypi.local/install.php

oder: http://192.168.X.X/install.php (ersetze X durch deine IP)

→ Du solltest nun das Installationsformular sehen.

Schritt 5 – Konfiguration abschließen

Trage im Formular ein:

Wiki-Titel: z. B. „Mein Pi-Wiki“

Admin-Benutzername & Passwort

E-Mail (optional)

Sprache: Deutsch

Lizenz: „Keine Lizenz“ oder „Creative Commons“

ACL aktivieren: ✅

→ Klicke auf „Speichern“

Schritt 6 – Wiki testen

Nach der Installation:

Startseite: http://raspberrypi.local/doku.php?id=start

Adminbereich: http://raspberrypi.local/doku.php?do=admin

💡 Hinweis bei Setup-Fehler („datadir not found“)

Falls nach der Installation folgende Fehlermeldung erscheint:

DokuWiki Setup Error The datadir ('pages') at /var/www/html/data/pages is not found, isn't accessible or writable.

Dann hast du entweder:

den DokuWiki-Ordner unvollständig hochgeladen (fehlende `data`-Verzeichnisse)

oder die Dateirechte nicht korrekt gesetzt

Lösung:

1. DokuWiki vollständig hochladen (alle Ordner wie `data`, `conf`, `inc` etc.) 2. Rechte korrekt setzen:

sudo chown -R pi:www-data /var/www/html sudo chmod -R 775 /var/www/html

3. Rufe danach erneut `install.php` auf und führe den Setup korrekt durch.

Was du jetzt kannst

– DokuWiki korrekt im Standard-Webverzeichnis installiert – Dateien per FileZilla übertragen und verwaltet – Rechte so gesetzt, dass Apache UND du Zugriff haben – Fehler beim Setup erfolgreich gelöst – Browserbasierte Einrichtung abgeschlossen

Nächste Schritte

→ Lektion 5 – Zugriff im lokalen Netzwerk

© Olaf Droste Products Immermannstr. 31, 44147 Dortmund – www.olaf-droste-products.net