Herzlich willkommen! Du versuchst, MediaWiki zu installieren, und bist auf Probleme gestoßen? Keine Sorge, das passiert den Besten! Die Installation von MediaWiki, der Software hinter Wikipedia, kann manchmal eine Herausforderung sein, besonders wenn man neu in der Welt der Webserver, Datenbanken und Konfigurationsdateien ist. Aber keine Panik! Wir haben eine umfassende, schrittweise Anleitung zusammengestellt, die dir helfen wird, die häufigsten Stolpersteine zu überwinden und dein eigenes Wiki zum Laufen zu bringen.
Warum ist die MediaWiki Installation so kompliziert?
Bevor wir uns in die Details stürzen, lass uns kurz verstehen, warum die MediaWiki Installation manchmal so knifflig sein kann. MediaWiki ist eine mächtige Software, die auf mehreren Komponenten basiert:
- Webserver: Du brauchst einen Webserver (wie Apache oder Nginx), um die MediaWiki-Dateien bereitzustellen und Benutzern den Zugriff auf dein Wiki zu ermöglichen.
- PHP: MediaWiki ist in PHP geschrieben, daher musst du PHP auf deinem Server installiert und konfiguriert haben.
- Datenbank: MediaWiki speichert alle Inhalte, Benutzerdaten und Konfigurationen in einer Datenbank (meistens MySQL/MariaDB oder PostgreSQL).
Jede dieser Komponenten muss korrekt installiert und konfiguriert sein, damit MediaWiki einwandfrei funktioniert. Ein Fehler an einer Stelle kann zu Problemen bei der Installation oder im Betrieb führen.
Voraussetzungen: Was du vor der Installation brauchst
Bevor du mit der eigentlichen Installation beginnst, stelle sicher, dass du folgende Voraussetzungen erfüllst:
- Einen Webserver: Apache oder Nginx sind die gängigsten Optionen. Wir empfehlen Apache, da es in dieser Anleitung einfacher zu konfigurieren ist.
- PHP: Stelle sicher, dass PHP installiert und konfiguriert ist. Du benötigst mindestens PHP 7.3, aber neuere Versionen (8.0+) werden empfohlen.
- Eine Datenbank: MySQL/MariaDB oder PostgreSQL. Stelle sicher, dass du einen Datenbank-Benutzer und eine Datenbank für MediaWiki erstellt hast.
- Zugriff auf die Kommandozeile (optional, aber empfohlen): Der Zugriff auf die Kommandozeile deines Servers (z.B. über SSH) erleichtert einige Schritte.
- Grundlegendes Verständnis von Webservern und Datenbanken: Ein grundlegendes Verständnis ist hilfreich, aber nicht zwingend erforderlich. Diese Anleitung soll dir auch als Anfänger helfen.
Schritt-für-Schritt-Anleitung zur MediaWiki Installation
Jetzt geht es ans Eingemachte! Folge diesen Schritten sorgfältig, um MediaWiki erfolgreich zu installieren.
Schritt 1: MediaWiki herunterladen
Lade die neueste Version von MediaWiki von der offiziellen Website herunter: https://www.mediawiki.org/wiki/Download. Wähle die Version, die deinen Bedürfnissen entspricht (normalerweise die stabilste Version).
Schritt 2: MediaWiki auf den Webserver hochladen
Entpacke die heruntergeladene Datei. Du erhältst einen Ordner namens „mediawiki-1.XX.X” (die Versionsnummer kann abweichen). Lade diesen Ordner auf deinen Webserver hoch. Der genaue Speicherort hängt von deiner Webserver-Konfiguration ab, ist aber normalerweise ein Unterverzeichnis wie `/var/www/html/wiki/` oder `/home/deinbenutzername/public_html/wiki/`. Du kannst einen FTP-Client oder SSH (mit `scp`) verwenden, um die Dateien hochzuladen.
Schritt 3: Berechtigungen setzen (Wichtig!)
Stelle sicher, dass der Webserver-Benutzer (z.B. `www-data` unter Debian/Ubuntu oder `apache` unter CentOS/RHEL) Schreibzugriff auf den Ordner `mediawiki-1.XX.X/cache` und den Ordner `mediawiki-1.XX.X/images` hat. Dies ist wichtig, damit MediaWiki Bilder hochladen und zwischenspeichern kann. Du kannst dies über die Kommandozeile tun:
chown -R www-data:www-data /var/www/html/wiki/cache
chown -R www-data:www-data /var/www/html/wiki/images
chmod -R 775 /var/www/html/wiki/cache
chmod -R 775 /var/www/html/wiki/imagesErsetze `/var/www/html/wiki/` durch den tatsächlichen Pfad zu deinem MediaWiki-Ordner und `www-data` durch den tatsächlichen Webserver-Benutzer, falls er anders ist.
Schritt 4: Den MediaWiki-Installer aufrufen
Öffne deinen Webbrowser und navigiere zu der URL, unter der du MediaWiki hochgeladen hast (z.B. `http://deine-domain.de/wiki/`). Du solltest automatisch zum MediaWiki-Installer weitergeleitet werden. Wenn nicht, versuche, die Datei `index.php` im MediaWiki-Ordner direkt aufzurufen (z.B. `http://deine-domain.de/wiki/index.php`).
Schritt 5: Den Installationsprozess durchlaufen
Der MediaWiki-Installer führt dich durch den Installationsprozess. Hier sind die wichtigsten Schritte:
- Sprache auswählen: Wähle deine bevorzugte Sprache für die Installation.
- Umgebungsprüfung: Der Installer prüft, ob alle Voraussetzungen erfüllt sind (PHP-Version, Datenbankverbindung usw.). Wenn Fehler auftreten, behebe sie, bevor du fortfährst.
- Datenbank konfigurieren: Gib die Details deiner Datenbank an: Datenbanktyp (MySQL/MariaDB oder PostgreSQL), Hostname (meistens `localhost`), Datenbankname, Benutzername und Passwort.
- Wiki-Name und Administrator-Konto festlegen: Gib deinem Wiki einen Namen und erstelle ein Administratorkonto mit einem Benutzernamen, einem Passwort und einer E-Mail-Adresse.
- Optionale Einstellungen: Konfiguriere optionale Einstellungen wie die Lizenz, die Suchmaschine und die Erweiterungen. Du kannst diese Einstellungen später ändern.
- Installation abschließen: Der Installer erstellt die Datenbanktabellen und schreibt die Konfigurationsdatei `LocalSettings.php`.
Schritt 6: Konfigurationsdatei herunterladen und platzieren
Nachdem der Installer abgeschlossen ist, bietet er dir die Datei `LocalSettings.php` zum Download an. Lade diese Datei herunter und platziere sie im MediaWiki-Stammverzeichnis (z.B. `/var/www/html/wiki/`).
Schritt 7: Installation abschließen
Fertig! Dein MediaWiki sollte jetzt unter der URL erreichbar sein, unter der du es installiert hast (z.B. `http://deine-domain.de/wiki/`). Melde dich mit dem von dir erstellten Administratorkonto an und beginne mit der Konfiguration und Anpassung deines Wikis.
Häufige Probleme und Lösungen
Trotz sorgfältiger Vorbereitung können bei der Installation von MediaWiki Probleme auftreten. Hier sind einige häufige Probleme und ihre Lösungen:
- „Verbindungsfehler zur Datenbank”: Stelle sicher, dass die Datenbank läuft, der Datenbank-Benutzer die erforderlichen Berechtigungen hat und die Datenbankdetails im Installer korrekt eingegeben wurden. Überprüfe auch, ob der MySQL/MariaDB-Server so konfiguriert ist, dass er Verbindungen von außerhalb des Servers zulässt (falls dein Webserver und Datenbankserver auf verschiedenen Maschinen laufen).
- „PHP-Erweiterung fehlt”: Der Installer meldet, dass eine bestimmte PHP-Erweiterung fehlt (z.B. `mbstring`, `intl`, `xml`). Installiere die fehlende Erweiterung mit dem Paketmanager deines Systems (z.B. `apt install php-mbstring` unter Debian/Ubuntu oder `yum install php-mbstring` unter CentOS/RHEL) und starte deinen Webserver neu.
- „Internal Server Error” (500): Dies deutet oft auf einen Fehler in der Konfigurationsdatei `.htaccess` oder auf falsche Dateiberechtigungen hin. Überprüfe die Fehlerprotokolle deines Webservers (z.B. `/var/log/apache2/error.log` oder `/var/log/nginx/error.log`), um die Ursache des Fehlers zu finden.
- Weiße Seite: Eine weiße Seite deutet in der Regel auf einen PHP-Fehler hin. Aktiviere das PHP-Fehlerreporting, um den Fehler anzuzeigen. Füge dazu folgende Zeilen am Anfang der `LocalSettings.php`-Datei hinzu:
error_reporting( E_ALL ); ini_set( 'display_errors', 1 );Entferne diese Zeilen, sobald du den Fehler behoben hast, da die Anzeige von Fehlern auf einer Produktionsseite ein Sicherheitsrisiko darstellen kann.
- Bilder werden nicht angezeigt: Überprüfe, ob der Webserver-Benutzer Schreibzugriff auf den Ordner `images` hat (siehe Schritt 3). Stelle auch sicher, dass der Pfad zu den Bildern in der `LocalSettings.php`-Datei korrekt ist.
Zusätzliche Tipps und Tricks
- Verwende eine virtuelle Maschine oder einen Container: Die Installation von MediaWiki in einer virtuellen Maschine (z.B. mit VirtualBox oder VMware) oder einem Container (z.B. mit Docker) isoliert dein Wiki von deinem Hauptsystem und erleichtert die Wiederherstellung im Falle eines Fehlers.
- Erstelle ein Backup deiner Datenbank: Erstelle regelmäßig ein Backup deiner MediaWiki-Datenbank, um Datenverlust zu vermeiden.
- Halte MediaWiki und PHP aktuell: Aktualisiere MediaWiki und PHP regelmäßig, um Sicherheitslücken zu schließen und von neuen Funktionen zu profitieren.
- Nutze die MediaWiki-Community: Die MediaWiki-Community ist sehr aktiv und hilfsbereit. Wenn du auf Probleme stößt, findest du oft Hilfe in den Foren, auf den Mailinglisten oder im IRC-Kanal.
Wir hoffen, diese Anleitung hat dir geholfen, deine MediaWiki-Installation erfolgreich abzuschließen! Viel Spaß beim Aufbau deines eigenen Wikis!