[[Vorlage(getestet, noble)]]

{{{#!vorlage Wissen
[:Pakete installieren: Installation von Programmen]
[:Terminal: Ein Terminal verwenden]
[:mit Root-Rechten arbeiten:]
[:Editor: Einen Editor verwenden]
[:PHP: Grundkenntnisse in der Skriptsprache PHP]
}}}
[[Inhaltsverzeichnis()]]

[[Bild(Logo 48 align=left)]]
MediaWiki ist eine in PHP geschriebene Wikisoftware der Wikimedia Foundation, zu der auch Wikipedia gehört. Es handelt sich hierbei um freie Software unter der GNU GPL v2. Sie ist dafür ausgelegt, hochverfügbar zu sein und eignet sich daher eher weniger für kleine Wikis, wo es auf geringen Speicherplatz und wenig Arbeitsspeicherauslastung ankommt. Trotzdem erfreut sie sich großer Beliebtheit auch bei kleineren Wikis aufgrund der einfachen Bedienbarkeit.

Als Datenbank kommt normalerweise [:MariaDB:] zum Einsatz, jedoch besteht auch die Möglichkeit, [:MySQL:], [:PostgreSQL:] oder [:SQLite:] stattdessen zu verwenden. Da die Standardinstallation allerdings von MariaDB ausgeht, wird im Folgenden nur darauf eingegangen.

= Installation =

== Voraussetzungen ==
Als Unterbau für MediaWiki wird [:LAMP:] installiert mit ein paar PHP-Erweiterungen. Wahlweise kann auch [:nginx:] statt [:Apache:] eingesetzt werden, worauf hier nicht weiter eingegangen wird.

{{{#!vorlage Paketinstallation
apache2
libapache2-mod-php
php
php-mysql
mariadb-server, universe
php-xml
php-mbstring, universe
php-intl, universe
}}}

Zunächst muss dem root-Benutzer von MariaDB noch ein Passwort vergeben werden. Hierfür melden wir uns zunächst als `root` bei MariaDB an. Zum Anmelden muss man Root-Rechte [3] haben.

{{{#!vorlage Befehl
sudo mariadb -u root
}}}

Nun wird das Passwort des root-Benutzers in der MariaDB-Eingabeaufforderung geändert:

{{{#!vorlage Befehl
ALTER USER 'root'@'localhost'
IDENTIFIED BY 'MariaDBRootPasswort_BitteÄndern';
FLUSH privileges;
QUIT;
}}}


== Aus den Paketquellen (veraltete Version) ==

MediaWiki kann aus den offiziellen Paketquellen installiert [1] werden. Dies wird allerdings nicht empfohlen, da es sich hier meist um veraltete, nicht mehr unterstützte Versionen handelt ([https://www.mediawiki.org/wiki/Version_lifecycle Versionszyklus] {en}). Aktuellere Versionen und eine alternative Installationsmethode gibt es weiter [#manuelle-Installation-aktueller-unterstuetzter-Versionen unten].

{{{#!vorlage Paketinstallation
mediawiki, universe
}}}

== manuelle Installation aktueller, unterstützter Versionen ==

Es gibt mehrere [https://www.mediawiki.org/wiki/Version_lifecycle/de unterstützte Versionen] {de}. Von der [https://www.mediawiki.org/wiki/Download Downloadseite] {de} sucht man sich die gewünschte Version, und lädt die "stabile" oder "LTS"-Version (Stand Juli 2025 1.43.x) und mittels `wget` herunter (das anschließende Verifizieren der Signatur ist optional, aber empfehlenswert):

{{{#!vorlage Befehl
cd /tmp/
wget https://releases.wikimedia.org/mediawiki/1.43/mediawiki-1.43.2.tar.gz
wget https://releases.wikimedia.org/mediawiki/1.43/mediawiki-1.43.2.tar.gz.sig
gpg --fetch-keys "https://www.mediawiki.org/keys/keys.txt" # Import der MediaWiki Entwickler-Schlüssel
gpg --verify mediawiki-1.43.2.tar.gz.sig mediawiki-1.43.2.tar.gz
}}}

Nun wird das Archiv entpackt, in das Wurzel-Verzeichnis des Webservers kopiert und anschließend gelöscht:

{{{#!vorlage Befehl
tar -xzvf mediawiki-1.43.2.tar.gz
sudo mv mediawiki-1.43.2 /var/www/html/mediawiki
rm mediawiki-1.39.7.tar.gz
}}}

Der Benutzer und Benutzergruppe müssen noch angepasst werden an die von Apache:

{{{#!vorlage Befehl
cd /var/www/html
sudo chown www-data:www-data -R mediawiki/
}}}

=== Deinstallation ===
Zum Deinstallieren müssen nur zwei Schritte unternommen werden:

 1. den Ordner '''/var/www/html/mediawiki''' löschen
 1. die Datenbank `wikidb` und den MariaDB-Benutzer `wikiuser` löschen

Hat man die '''php.ini''' verändert, so kann diese Änderung natürlich auch rückgängig gemacht werden.

= Einrichtung =

== MariaDB einrichten ==

Zunächst muss man sich wieder als Superuser [3] bei MariaDB anmelden:

{{{#!vorlage Befehl
mariadb -u root -p    # Oben vergebenes MariaDBRootPasswort_BitteÄndern eingeben nach `Enter`
}}}

In der MariaDB-Konsole legt man einen Benutzer und eine Datenbank für das MediaWiki an. `wikiuser` und `wikidb` können verändert werden, sind der Konsistenz dieses Artikels wegen jedoch so gewählt.

{{{#!vorlage Befehl
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'wikiuserPasswort_BitteÄndern';
CREATE DATABASE wikidb;
GRANT ALL PRIVILEGES ON wikidb.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;
QUIT;
}}}

== PHP einrichten ==
{{{#!vorlage Hinweis
Diese Einstellungen sind optional, können aber helfen, die Leistung zu verbessern oder Problemen vorzubeugen. MediaWiki läuft auch ohne diese Änderungen.
}}}

Der Pfad zur Konfigurationsdatei '''php.ini''' befindet sich unter '''/etc/php/VERSION/apache2/php.ini''', die Datei muss erstellt werden. Hier kann die maximale Datei-Upload-Größe festgelegt werden, in diesem Beispiel 20 MB:

{{{
upload_max_filesize = 20M
}}}

== Grundkonfiguration ==

[[Vorlage(Bildunterschrift, mediawiki-setup.png, 500, "auf set up wiki klicken", align=right)]]
Die MediaWiki-Installation setzt sich im Browser fort. Steht einem auf dem Server ein Browser zur Verfügung, so kann man einfach `http://localhost/mediawiki` aufrufen. Falls dies nicht möglich, weil zum Beispiel kein XServer vorhanden ist, so sollte es möglich sein, ihn an einem anderen Computer mit seiner IP-Adresse zu erreichen: `http://IP_ADRESSE_DES_SERVERS/mediawiki`. Dabei sollte möglichst schnell ein Zertifikat für die Webseite besorgt werden, z. B. via [:certbot:].

Einmalig muss das Setup durch Klick auf den Link ''"set up the wiki"'' durchgeführt werden. 

=== Sprache festlegen ===    
Als erstes werden Sie gefragt, welche Sprache das Wiki haben soll und in welcher Sie durch die Konfiguration geführt werden wollen.

=== Installationsumgebung prüfen ===
Hier wird geprüft, ob alles Notwendige installiert ist. Es werden viele Warnungen angezeigt von optional installierbaren Erweiterungen wie ImageMagick, womit sich dieser Artikel jedoch nicht befasst.

Wichtig ist, das hier ''"Die Installationsumgebung wurde geprüft. MediaWiki kann installiert werden."'' steht.

=== Mit der Datenbank verbinden ===
[[Vorlage(Bildunterschrift, Grundkonfiguration_2, 200, "Datenbankeinstellungen", right)]]
Die zuvor erstellte Datenbank `wikidb` wird hier für MediaWiki eingerichtet.

Wie im Bildschirmfoto gezeigt, muss hier für `Name der Datenbank` die zuvor erstellte Datenbank genannt werden, in diesem Fall `wikidb`, und das Feld ''"Präfix der Datenbanktabelle"'' bleibt leer. Der ''"Name des Datenbanknutzers"'' ist analog `wikiuser` mit zugehörigem ''"Passwort des Datenbanknutzers"''.

Nach Klick auf ''"Weiter"'' wird man gefragt, ob man ''"dasselbe Datenbankkonto wie während des Installationsvorgangs verwenden"'' möchte. Dies ist der Fall.

=== Name des Wikis und Administratorkonto ===
Nun wird man gefragt, wie denn das Wiki heißen soll. Im Falle von ubuntuusers würde man hier wohl `ubuntuusers` einfügen.

Der Punkt bei `Entspricht dem Namen des Wikis:*` kann gesetzt bleiben.

Auf der zweiten Hälfte der Seite wird das Administratorkonto eingerichtet. Es bietet sich an, das Konto auch `Administrator` zu nennen. An die hier eingetragene E-Mail-Adresse werden künftig Service-E-Mails verschickt.

=== weitere Optionen ===
Hier können noch weitere Einstellungen vorgenommen werden, worauf hier aber nicht eingegangen werden soll. Diese sind auch nur optional.

=== Fertigstellung ===
Nachdem MediaWiki die Eingaben verarbeitet hat, wird ein Download der Datei '''LocalSettings.php''' gestartet. Diese Datei wird gespeichert. Sie ist enthält alle wichtigen Einstellungen des Wikis in PHP [5].

== LocalSettings.php ==

Hier muss gegebenenfalls die URL des Servers angepasst werden, in diesem Beispiel zu ''beispiel.de'':

{{{#!code html+php
$wgServer = "http://beispiel.de";
}}}

Diese Datei muss noch ins Stammverzeichnis der MediaWiki-Installation kopiert werden:

{{{#!vorlage Befehl
sudo cp ~/Downloads/LocalSettings.php /etc/mediawiki/ # bei Installation aus den Paketquellen
sudo cp ~/Downloads/LocalSettings.php /var/www/html/mediawiki/ # bei manueller Installation
}}}

Da hier auch die Anmeldedaten für die Datenbank hinterlegt sind, müssen der Benutzer und die Benutzergruppe sowie die Zugriffsrechte angepasst werden:

{{{#!vorlage Befehl
cd /var/www/html/mediawiki
sudo chown root:www-data LocalSettings.php
sudo chmod 440 LocalSettings.php
}}}

Nun kann mit Klick auf '''enter your wiki''' das angelegte Wiki betreten werden. Darin wird das weitere Vorgehen beschrieben.

= Benutzung =

Nun kann begonnen werden, das eigene Wiki mit Artikeln zu bevölkern. Dazu ist anfangs eine gewisse Gewöhnung an die Wiki-Syntax notwendig, wozu sich der [https://www.mediawiki.org/wiki/Help:Contents/de MediaWiki Helpdesk] {de} empfiehlt. Dieser bietet eine Übersicht der Hilfeseiten zu den einzelnen Syntaxelementen und der Struktur des Wikis und seiner Artikel. Ein Einstieg in Feinheiten wie die [https://www.mediawiki.org/wiki/Help:Templates/de Template-Sprache] {de} von MediaWiki ist ebenfalls lohnend. Für schnelle Hilfe zu der grundlegenden Formatierung bietet sich auch das [https://www.mediawiki.org/wiki/Cheatsheet MediaWiki Cheatsheet] {en} an. Vieles davon mag schon gewohnt sein; [https://ubuntuusers.de/inyoka Inyoka] etwa hat verschiedene syntaktische Elemente aus der Syntax von Wikipedia übernommen.

Eine Hilfe für die Einarbeitung stellt dabei dar, dass die Dokumentation größtenteils auf Deutsch {de} übersetzt ist. 

== Erscheinungsbild ==

Viele Einstellungen für das Erscheinungsbild lassen sich in der Datei '''LocalSettings.php''' im Wurzelverzeichnis des Wikis ('''/var/www/html/mediawiki/''') tätigen. Unter anderem werden darüber [#Erweiterungen Erweiterungen] geladen.
Zudem lassen sich darüber diverse, separat zu installierende [https://www.mediawiki.org/wiki/Category:All_skins Skins] {en} laden, um die Oberfläche dem eigenen Geschmack anzupassen. 

Eine Übersicht aller Konfigurationseinstellungen findet sich [https://www.mediawiki.org/wiki/Manual:Configuration_settings hier] {de}, ein Handbuch für die Datei '''LocalSettings.php''' gibt es auf [https://www.mediawiki.org/wiki/Manual:LocalSettings.php/de dieser Seite] {de}.

== Erweiterungen ==

Mithilfe von Erweiterungen lassen sich das Erscheinungsbild und die Funktionsweise von MediaWiki erweitert anpassen. Diese werden von der MediaWiki-Seite heruntergeladen und in die lokale MediaWiki-Instanz [https://www.mediawiki.org/wiki/Manual:Extensions/de#Installieren_einer_Erweiterung integriert] {de}. Eine Übersichtsseite mit weiterführenden Links gibt es [https://www.mediawiki.org/wiki/Manual:Extensions/de hier] {de}. 

Neben [https://www.mediawiki.org/wiki/Category:Extensions_by_category/de bestehenden Erweiterungen] {de} können auch selbst entwickelte unkompliziert genutzt werden. Bei der Entwicklung kommt [:PHP:] zum Einsatz.

== Administration des Wikis ==

Hierfür sind drei Punkte wichtig:
 1. Administration über das Webinterface
 1. Sicherungen der Daten
 1. Updates einspielen

=== Administration über das Webinterface ===
Im Vergleich zu einem "normalem" Benutzerkonto hat das Administratorkonto wesentlich mehr Rechte. Meldet man sich als Administrator an und klickt auf den Link "Spezialseiten" auf der linken Seite, so sind einige Einträge fett geschrieben. Diese Funktionen stehen nur einem Administratorkonto zur Verfügung.
Hierzu gehören:
 * Nicht beobachtete Seiten
 * Benutzer freigeben
 * Benutzer sperren
 * Gelöschte Beiträge
 * Gelöschte Seiten anzeigen
 * Inhaltsmodell einer Seite ändern
 * Seiten importieren
 * Versionsgeschichten vereinen

=== Sicherungen der Daten ===
Damit bei einem Defekt nicht alle Daten verloren gehen, müssen natürlich Sicherungen erfolgen. Hierzu müssen zwei Sachen gesichert werden:
 * die Datenbank des Wikis
 * Das Root-Verzeichnis des Wikis

Dazu gibt es auch einen [https://www.mediawiki.org/wiki/Manual:Backing_up_a_wiki/de Artikel in der MediaWiki-Dokumentation] {de}.

==== Sicherung der Datenbank ====
Hierzu bietet sich folgender Artikel an: [:MySQL/Backup:]
{{{#!vorlage Hinweis
Damit während der Sicherung die Datenbank nicht verändert werden kann, muss man folgendes in der LocalSettings.php ergänzen:
{{{#!code php
$wgReadOnly = 'Dumping Database, Access will be restored shortly';
\}}}
}}}

==== Sicherung des Root-Verzeichnisses ====
Hier sind vor allem die Datei '''LocalSettings.php''' und der Ordner '''images''' wichtig. Es empfiehlt sich aber, das komplette Verzeichnis in regelmäßigen Abständen zu sichern.

=== Updates einspielen bei manueller Installation ===

Dieser Abschnitt soll sich nur mit der Einspielung eines sogenannten ''Minor Update'' für eine installierte LTS-Version befassen. Für die Aktualisierung auf eine neue Version ist die volle Kenntnissnahme der folgende Seite empfehlenswert: [https://www.mediawiki.org/wiki/Manual:Upgrading/de Handbuch Aktualisierung] {de}. Zudem sollte immer der Abschnitt zur Aktualisierung in den [https://www.mediawiki.org/wiki/Release_notes/de Versionshinweisen] {de} der Version auf die aktualisiert werden soll beachtet werden.

Hier am Beispiel von Version 1.39.6 auf 1.39.7.

Zuerst wird ein Terminal geöffnet und die Datenbank gesichert:
{{{#!vorlage Befehl
mysqldump --user=wikiuser --password=wikidb_userpassword wikidb > BackupMediawiki.sql
}}}

Für andere Datenbanksysteme ist die Vorgehensweise [https://www.mediawiki.org/wiki/Manual:Upgrading/de#Sichern_vorhandener_Dateien_und_der_Datenbank dokumentiert] {de}. 

Nun wechselt man in das Verzeichnis '''/tmp/'''. Dorthin lädt man die aktuelle Version herunter, die anschließend entpackt wird.

{{{#!vorlage Befehl
cd /tmp/
wget https://releases.wikimedia.org/mediawiki/1.39/mediawiki-1.39.7.tar.gz
tar -xzvf mediawiki-1.39.7.tar.gz; rm mediawiki-1.39.7.tar.gz
}}}

Bei der Aktualisierung wird der Ordner '''images/''', beinhaltend die von den Benutzern hochgeladenen Bilder, und die Datei '''LocalSettings.php''' von der alten Version übernommen (nebst ggf. [https://www.mediawiki.org/wiki/Manual:Upgrading/de#Andere_Dateien anderen Dateien] {de}):

{{{#!vorlage Befehl
cd mediawiki-1.39.7/
rm -R images/
sudo cp -R /var/www/html/mediawiki/images/ ./
sudo cp /var/www/html/mediawiki/LocalSettings.php ./
}}}

Damit die neue Version die alte Version ersetzen kann, wird der Ordner der alten Version in einen Backup-Ordner verschoben (alternativ kann er auch gelöscht werden):

{{{#!vorlage Befehl
sudo mkdir /var/www/backup
sudo mv /var/www/html/mediawiki/ /var/www/html/backup/mediawiki27-02-2020
}}}

Nun wird die neue Version dorthin kopiert:

{{{#!vorlage Befehl
sudo mv /tmp/mediawiki-1.31.12/ /var/www/html/mediawiki
}}}

Anschließend werden noch die Benutzer, Benutzergruppen und Zugriffsrechte angepasst:

{{{#!vorlage Befehl
cd /var/www/html/
sudo chown -R www-data:www-data mediawiki/
cd mediawiki/
sudo chown root:www-data LocalSettings.php
sudo chmod 440 LocalSettings.php
}}}

Die neue Version ist jetzt über das Webinterface mit der URL http://beispiel.de/mediawiki/mw-config/index.php aufzurufen, wo die Datenbank-Aktualisierung [https://www.mediawiki.org/wiki/Manual:Upgrading/de#Web-Browser vorgenommen wird] {de}.

= Links =
 * [https://www.mediawiki.org/wiki/MediaWiki/de Offizielle Projektseite] {de} {nl} {en} {fr} {it} {es} u.v.m.
  * [https://www.mediawiki.org/wiki/Documentation/de Dokumentation]
 * [ubuntu_doc:community/MediaWiki:]
 * [packages:mediawiki:] - Paketinformationen
 * [https://www.mediawiki.org/wiki/Version_lifecycle/de Versionsgeschichte von MediaWiki] {de}

#tag: Server, Wikisoftware