Inhaltsverzeichnis

Lektion 4 – DokuWiki installieren & konfigurieren

Ziel dieser Lektion: Du installierst DokuWiki lokal auf deinem Raspberry Pi, richtest die ersten Einstellungen ein und behebst typische Einsteigerfehler.

DokuWiki herunterladen und vorbereiten

  1. Lade die aktuelle Stable-Version als `.tgz`-Datei herunter
  2. Entpacke den Inhalt lokal auf deinem Rechner (z. B. `dokuwiki-2024-XX-XX`)

Dateien auf den Raspberry Pi übertragen

Nutze FileZilla (SFTP), um die entpackten Dateien auf den Pi zu übertragen.

Verbindungsdaten:

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

So gehst du vor:

Hinweis zur Nutzung von FileZilla: Falls du beim Löschen oder Überschreiben von Dateien Probleme bekommst, kannst du den Besitz des Zielverzeichnisses vorübergehend an den Benutzer `pi` übergeben – so lassen sich Änderungen via SFTP komfortabler vornehmen:

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

Nach dem Upload solltest du die Dateiberechtigungen wieder korrekt setzen (siehe nächster Abschnitt).

Dateiberechtigungen korrekt setzen

Damit DokuWiki korrekt funktioniert:

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 {} \;

→ Apache hat jetzt vollständige Rechte, und alle Dateien sind korrekt lesbar/ausführbar.

🔍 Was bedeuten 755 und 644 bei `chmod`?

Diese Zahlen sind sogenannte numerische Dateiberechtigungen, bei denen jede Ziffer für die Rechte einer Benutzergruppe steht:

  • Erste Ziffer → Besitzer
  • Zweite Ziffer → Gruppe
  • Dritte Ziffer → Alle anderen

Die Ziffern stehen für:

  • `7` = Lesen (4) + Schreiben (2) + Ausführen (1) → volle Rechte
  • `5` = Lesen (4) + Ausführen (1)
  • `4` = Lesen (4)

Beispiele:

  • `755` = Besitzer darf alles, Gruppe & andere dürfen lesen + ausführen
  • `644` = Besitzer darf lesen + schreiben, Gruppe & andere dürfen nur lesen

So stellst du sicher, dass z. B. HTML/PHP-Dateien korrekt ausgeführt und gelesen werden können, aber nicht jeder diese ändern darf.

DokuWiki im Browser installieren

Öffne den Browser auf deinem Rechner:

- `http://raspberrypi.local/install.php` - oder direkt per IP: `http://192.168.X.X/install.php`

→ Es erscheint das Installationsformular von DokuWiki.

Konfiguration im Web-Installer

Trage folgende Informationen ein:

Dann auf „Speichern“ klicken.

Funktion prüfen

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

→ DokuWiki sollte jetzt betriebsbereit sein.

Fehler: Setup Error (datadir/pages fehlt)

Wenn du folgenden Fehler siehst:

The datadir ('pages') is not found, isn't accessible or writable.

Dann:

- Überprüfe, ob du den gesamten Ordner (inkl. `data`, `conf`, `lib`) übertragen hast - Setze die Berechtigungen nochmals korrekt (siehe oben)

Fehler: xml_parser_create fehlt

Wenn diese Fehlermeldung erscheint:

Call to undefined function xml_parser_create()

→ Die PHP-XML-Erweiterung fehlt. Installiere sie mit:

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

Was du jetzt kannst

  • DokuWiki vollständig auf dem Pi installieren und einrichten
  • Dateiberechtigungen korrekt setzen
  • Typische Fehler wie 403 oder Setup-Fehler lösen
  • Apache mit PHP-XML für DokuWiki konfigurieren

Nächste Schritte

Lektion 5 – Zugriff im lokalen Netzwerk (WLAN/LAN)


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