Dies ist eine alte Version des Dokuments!
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:
- 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