Lektion 4 – DokuWiki installieren & konfigurieren

🎯 Ziel: DokuWiki lokal auf dem Raspberry Pi einrichten – vollständig und funktionsfähig über den Browser.

Schritt 1 – DokuWiki herunterladen

Besuche → https://download.dokuwiki.org

Lade die aktuelle Stable-Version (.tgz) herunter

Entpacke den Ordner lokal auf deinem Rechner (z. B. `dokuwiki-2024-XX-XX`)

Schritt 2 – Dateien auf den Pi übertragen

Starte FileZilla und verbinde dich per SFTP mit dem Pi:

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

→ Navigiere zu: `/var/www/html` → Lösche ggf. die `index.html` → Ziehe den kompletten Inhalt des entpackten DokuWiki-Ordners in dieses Verzeichnis

Schritt 3 – Dateiberechtigungen korrekt setzen

Damit DokuWiki reibungslos funktioniert und Apache Schreibzugriff hat:

sudo chown -R www-data:www-data /var/www/html sudo find /var/www/html -type d -exec chmod 755 {} \; sudo find /var/www/html -type f -exec chmod 644 {} \;

→ Dies gibt Apache (`www-data`) vollständige Kontrolle über das Webverzeichnis.

→ Falls du später mit FileZilla wieder bearbeiten willst, musst du den Besitzer ggf. zurück auf `pi` setzen – dies ist jedoch nicht empfohlen, solange DokuWiki betrieben wird.

Schritt 4 – DokuWiki im Browser installieren

Rufe im Browser auf:

`http://raspberrypi.local/install.php`

oder `http://192.168.X.X/install.php` (eigene IP verwenden)

→ Du solltest nun das Installationsformular von DokuWiki sehen.

Schritt 5 – Konfiguration im Browser abschließen

Fülle die Felder aus:

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

Admin-Benutzername + Passwort

Sprache: Deutsch

Lizenz: Privat oder Creative Commons

ACL aktivieren: ✅

→ Klicke auf „Speichern“.

Schritt 6 – Wiki starten und testen

Danach:

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

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

—

⚠️ Bekannte Fehler & Lösungen

🔴 Fehler 1: Setup Error – `datadir ('pages') not found`

Falls du diese Fehlermeldung bekommst:

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

Lösung:

Stelle sicher, dass der komplette Inhalt von DokuWiki hochgeladen wurde – inklusive `data/`, `conf/`, `lib/` etc.

Setze die Berechtigungen korrekt:

sudo chown -R www-data:www-data /var/www/html sudo find /var/www/html -type d -exec chmod 755 {} \; sudo find /var/www/html -type f -exec chmod 644 {} \;

→ Danach erneut `install.php` aufrufen.

🔴 Fehler 2: `Call to undefined function xml_parser_create()`

Falls du diese PHP-Fehlermeldung bekommst:

Fatal error: Uncaught Error: Call to undefined function xml_parser_create()

Lösung:

Installiere die fehlende PHP-XML-Erweiterung:

sudo apt update sudo apt install php-xml sudo systemctl restart apache2

→ Danach Seite neu laden.

—

Was du jetzt kannst

Du hast DokuWiki korrekt im Apache-Standardverzeichnis installiert Du kennst den Umgang mit Dateirechten und Besitzern Du kannst häufige Fehler (403, XML) selbst beheben Du hast das Wiki per Browser eingerichtet und startbereit

Nächste Schritte

→ Lektion 5 – Zugriff im lokalen Netzwerk

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