📝 Lektion 4 – DokuWiki installieren & konfigurieren

Ziel: DokuWiki auf dem Raspberry Pi im lokalen Netzwerk installieren und nutzbar machen.

📦 Schritt 1 – DokuWiki herunterladen

1. Besuche https://download.dokuwiki.org 2. Lade die aktuelle Stable-Version als `.tgz` herunter 3. Entpacke den Inhalt auf deinem Rechner (z. B. `dokuwiki-2024-XX-XX`)

🔁 Schritt 2 – DokuWiki auf den Pi übertragen

Nutze FileZilla mit folgenden Einstellungen: - Protokoll: SFTP - Host: `raspberrypi.local` - Benutzername: `pi` - Passwort: (dein Raspberry-Pi-Passwort) - Port: `22` Navigiere zu `/var/www/html` → Lösche ggf. die `index.html` → Lade den kompletten Inhalt des DokuWiki-Ordners hoch

🔒 Schritt 3 – Dateiberechtigungen korrekt setzen

Damit Apache auf alle Dateien zugreifen und DokuWiki schreiben kann: 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 {} \;

🌐 Schritt 4 – DokuWiki im Browser aufrufen

Öffne einen Browser und gehe zu: - `http://raspberrypi.local/install.php` - oder: `http://192.168.X.X/install.php` (eigene IP) Du solltest das DokuWiki-Installationsformular sehen.

🧑‍💼 Schritt 5 – DokuWiki konfigurieren

Fülle die Felder wie folgt aus: - Wiki-Titel: z. B. „Mein Pi-Wiki“ - Admin-Benutzername + Passwort - Sprache: Deutsch - Lizenz: Privat oder Creative Commons - ACL aktivieren: ✅ - E-Mail (optional bei lokalem Betrieb) Klicke danach auf Speichern

✅ Schritt 6 – Installation testen

Nach der Installation: - Startseite: `http://raspberrypi.local/doku.php?id=start` - Adminbereich: `http://raspberrypi.local/doku.php?do=admin`

⚠️ Bekannte Fehler & Lösungen

Fehler: `The datadir ('pages') … is not found or not writable`

Dieser Fehler tritt auf, wenn DokuWiki nicht vollständig hochgeladen wurde → oder die Berechtigungen nicht korrekt sind. Lösung: 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: `Call to undefined function xml_parser_create()`

Dieser Fehler bedeutet, dass die PHP-XML-Erweiterung fehlt. Lösung: sudo apt update sudo apt install php-xml sudo systemctl restart apache2

🧱 Was du jetzt kannst

✓ DokuWiki vollständig auf dem Raspberry Pi einrichten ✓ Apache-Dateiberechtigungen korrekt setzen ✓ Fehlerquellen wie „403 Forbidden“ oder `xml_parser_create` erkennen und beheben

🔗 Nächste Schritte

Weiter zu Lektion 5 – Zugriff im lokalen Netzwerk

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