So installieren Sie MediaWiki auf Ubuntu 24.04

MediaWiki ist eine Open-Source-Wiki-Software, die in PHP und MySQL geschrieben ist. Es ist skalierbare und erweiterbare Wiki-Software, die von Seiten wie Wikipedia und Wikimedia betrieben wird. MediaWiki kann als Plattform für Zusammenarbeit und Dokumentation verwendet werden. Es ermöglicht Ihnen, Dokumentationen zu organisieren und sie für alle öffentlich zugänglich zu machen. Es unterstützt Mehrsprachigkeit und bietet Anpassungsmöglichkeiten für verschiedene Aspekte, von Themen/Skins, Plugins und Editoren.

Dieser Leitfaden zeigt Ihnen, wie Sie die MediaWiki-Software auf einem Ubuntu 24.04-Server installieren. Sie werden MediaWiki mit dem LAMP-Stack (Linux, Apache, MySQL/MariaDB und PHP) installieren und es dann mit HTTPS über Certbot und Letsencrypt sichern.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

• Einen Ubuntu 24.04-Server.
• Einen Nicht-Root-Benutzer mit Administratorrechten.
• Einen Domainnamen, der auf eine Server-IP-Adresse zeigt.

Abhängigkeiten installieren

Um MediaWiki zu installieren, müssen Sie sicherstellen, dass die Abhängigkeiten auf Ihrem System installiert sind. Derzeit erfordert die stabile Version von MediaWiki 1.41 PHP 8.1-83. In diesem Abschnitt installieren Sie Apache, den MariaDB-Server, PHP 8.3 und ImageMagick als Abhängigkeiten für MediaWiki.

Zuerst führen Sie den folgenden Befehl aus, um Ihr Ubuntu-Repository zu aktualisieren.

sudo apt update

Jetzt installieren Sie die Abhängigkeiten für MediaWiki mit dem folgenden Befehl. Geben Sie Y ein, um den Vorgang zu bestätigen. Damit installieren Sie die LAMP-Stack-Pakete (Apache, MySQL/MariaDB und PHP) sowie die ImageMagick-Pakete.

sudo apt install apache2 mariadb-server imagemagick libapache2-mod-php php php-common php-intl php-xml php-curl php-gd php-mbstring php-mysql php-apcu

Nachdem die Installation abgeschlossen ist, überprüfen Sie den Status des apache2-Dienstes mit dem folgenden Befehl. Sie werden sehen, dass der Apache-Webserver läuft und aktiviert ist.

sudo systemctl is-enabled apache2
sudo systemctl status apache2

Überprüfen Sie den mariadb-Dienst mit dem folgenden Befehl. Sie können sehen, dass der MariaDB-Server läuft und aktiviert ist.

sudo systemctl is-enabled mariadb
sudo systemctl status mariadb

Überprüfen Sie zuletzt die PHP-Version mit dem folgenden Befehl. Sie werden sehen, dass PHP 8.3 auf Ihrem System installiert ist.

sudo php -v

UFW einrichten

Fügen Sie das Profil Apache Full in UFW hinzu und aktivieren Sie es mit folgendem Befehl:

sudo ufw allow “Apache Full”

Überprüfen Sie nun die aktivierten Regeln in UFW mit dem folgenden ufw status-Befehl. Das Profil Apache Full öffnet Ports für sowohl HTTP- als auch HTTPS-Protokolle.

sudo ufw status

PHP konfigurieren

Nachdem Sie die Abhängigkeiten installiert haben, richten Sie PHP ein, indem Sie die Standardkonfigurationsdatei /etc/php/8.3/apache2/php.ini bearbeiten.

Führen Sie den folgenden nano-Befehl aus, um die PHP-Konfigurationsdatei /etc/php/8.3/apache2/php.ini zu öffnen.

sudo nano /etc/php/8.3/apache2/php.ini

Kommentieren Sie die Standard-PHP-Konfiguration mit den folgenden Einstellungen aus und ändern Sie sie. Stellen Sie sicher, dass Sie sowohl die Optionen memory_limit als auch date.timezone nach Bedarf anpassen.

date.timezone = Europe/Amsterdam  
upload_max_filesize = 80M  
memory_limit = 512M  
max_execution_time = 360

Speichern Sie die Datei und beenden Sie den Editor, wenn Sie fertig sind.

Führen Sie nun den folgenden Befehl aus, um den Apache-Webserver neu zu starten und Ihre PHP-Konfiguration anzuwenden.

sudo systemctl restart apache2

MariaDB-Server konfigurieren

Jetzt, wo PHP konfiguriert ist, sichern Sie den MariaDB-Server und erstellen eine neue Datenbank und einen neuen Benutzer für MediaWiki. Sie sichern MariaDB mit dem Dienstprogramm mariadb-secure-installation und erstellen dann eine neue Datenbank und einen neuen Benutzer über den mariadb-Client.

Sichern Sie Ihre MariaDB-Serverinstallation mit dem folgenden Befehl mariadb-secure-installation.

sudo mariadb-secure-installation

Jetzt werden Sie nach den folgenden MariaDB-Serverkonfigurationen gefragt:

• Die Standardinstallation von MariaDB kommt ohne Passwort, drücken Sie ENTER, wenn Sie nach dem Passwort gefragt werden.
• Geben Sie jetzt Y ein, um das MariaDB-Root-Passwort festzulegen. Geben Sie dann das neue Passwort für MariaDB ein und wiederholen Sie das Passwort.
• Geben Sie Y ein, um den anonymen Benutzer aus Ihrer MariaDB-Installation zu entfernen.
• Geben Sie erneut Y ein, wenn Sie gefragt werden, um den Remote-Login für den MariaDB-Root-Benutzer zu deaktivieren.
• Geben Sie Y ein, um die Standarddatenbank „test“ aus Ihrer MariaDB zu entfernen.
• Geben Sie schließlich Y ein, um die Tabellenberechtigungen neu zu laden und die neuen Änderungen anzuwenden.

Nachdem MariaDB gesichert ist, melden Sie sich mit dem folgenden Befehl beim MariaDB-Server an - Geben Sie Ihr root-Passwort ein, wenn Sie dazu aufgefordert werden.

sudo mariadb -u root -p

Führen Sie als Nächstes die folgenden Abfragen aus, um eine neue Datenbank und einen neuen Benutzer für MediaWiki zu erstellen. In diesem Beispiel erstellen Sie eine neue Datenbank mediawikidb, einen Benutzer mediawiki mit dem Passwort mediawikipassdb. Sie können die Datenbankdetails mit Ihren Informationen anpassen.

CREATE DATABASE mediawikidb;
CREATE USER mediawiki@localhost IDENTIFIED BY ‘mediawikipassdb’;
GRANT ALL ON mediawikidb.* TO mediawiki@localhost WITH GRANT OPTION;
FLUSH PRIVILEGES;

Führen Sie nun die folgende Abfrage aus, um die Berechtigungen für den Benutzer mediawiki zu überprüfen. Unten sehen Sie, dass der Benutzer mediawiki auf die Datenbank mediawikidb zugreifen kann.

SHOW GRANTS FOR mediawiki@localhost;

Geben Sie zuletzt quit ein, um den MariaDB-Server zu verlassen.

MediaWiki herunterladen

In diesem Abschnitt werden Sie den Quellcode von MediaWiki 1.41 herunterladen und das Installationsverzeichnis für MediaWiki einrichten.

Gehen Sie in das Verzeichnis /var/www und laden Sie den Quellcode von MediaWiki mit dem folgenden curl-Befehl herunter. Stellen Sie sicher, dass Sie die MediaWiki-Download-Seite besuchen, um die neueste Version zu erhalten.

cd /var/www/
curl -O https://releases.wikimedia.org/mediawiki/1.41/mediawiki-1.41.1.tar.gz

Nachdem Sie heruntergeladen haben, extrahieren Sie den Quellcode von MediaWiki und benennen das Verzeichnis in mediawiki um. Damit sollte Ihr Dokumentenstammverzeichnis für MediaWiki im Verzeichnis /var/www/mediawiki verfügbar sein.

tar -xvzf mediawiki-.tar.gz
mv mediawiki- /mediawiki/

Ändern Sie nun den Besitz des Verzeichnisses /var/www/mediawiki auf den Benutzer www-data und die Standardberechtigung auf 0755.

sudo chown -R www-data:www-data /var/www/mediawiki
sudo chmod 755 /var/www/mediawiki

Apache-virtuellen Host einrichten

Jetzt, wo Sie den Quellcode von MediaWiki heruntergeladen haben, besteht der nächste Schritt darin, eine neue Apache-virtuelle Hostdatei für die Ausführung von MediaWiki zu erstellen. Stellen Sie sicher, dass Sie einen Domainnamen haben, der auf Ihren MediaWiki-Server zeigt.

Zuerst führen Sie den folgenden Befehl aus, um das rewrite-Modul auf dem Apache-Webserver zu aktivieren.

sudo a2enmod rewrite

Erstellen Sie nun eine neue virtuelle Hostdatei /etc/apache2/sites-available/mediawiki.conf mit dem folgenden nano-Editorbefehl.

sudo nano /etc/apache2/sites-available/mediawiki.conf

Geben Sie die folgende Konfiguration ein und stellen Sie sicher, dass Sie die Option ServerName mit Ihrem Domainnamen ändern.

  
  
 ServerName wiki.howtoforge.local  
  
 ServerAdmin [email protected]  
 DocumentRoot /var/www/mediawiki  
  
 ErrorLog /var/log/apache2/wiki.howtoforge.local_error.log  
 CustomLog /var/log/apache2/wiki.howtoforge.local_access.log combined  
  
   
 Options FollowSymlinks  
 AllowOverride All  
 Require all granted  
   
  

Speichern Sie die Datei und schließen Sie den Editor, wenn Sie fertig sind.

Führen Sie als Nächstes den folgenden Befehl aus, um die virtuelle Hostdatei mediawiki.conf zu aktivieren und Ihre Apache-Syntax zu überprüfen. Wenn Sie eine korrekte Apache-Syntax haben, erhalten Sie die Ausgabe Syntax is OK.

sudo a2ensite mediawiki.conf
sudo apachectl configtest

Führen Sie schließlich den folgenden Befehl aus, um Apache neu zu starten und Ihre Änderungen anzuwenden. Damit sollte Ihre MediaWiki-Installation bereit sein.

sudo systemctl restart apache2

MediaWiki mit HTTPS sichern

In diesem Leitfaden werden Sie MediaWiki mit HTTPS sichern. Wenn Sie eine öffentliche Domain verwenden, können Sie kostenlose SSL-Zertifikate von Letsencrypt verwenden und HTTPS automatisch einrichten. Sie können SSL-Zertifikate generieren und HTTPS manuell für lokale Domainbenutzer einrichten.

Installieren Sie die Pakete certbot und python3-certbot-apache mit dem folgenden Befehl. Geben Sie Y ein, um die Installation zu bestätigen.

sudo apt install certbot python3-certbot-apache

Nachdem die Installation abgeschlossen ist, führen Sie den folgenden certbot-Befehl aus, um SSL/TLS-Zertifikate für Ihre MediaWiki-Installation zu generieren. Stellen Sie sicher, dass Sie die E-Mail-Adresse und den Domainnamen mit Ihren Informationen ändern.

sudo certbot –apache –agree-tos –redirect –hsts –staple-ocsp –email [email protected] -d wiki.howtoforge.local

Sie werden SSL/TLS-Zertifikate im Verzeichnis /etc/letsencrypt/live/domain.com sehen. Ihre MediaWiki-Installation sollte automatisch mit HTTPS gesichert sein.

MediaWiki installieren

Öffnen Sie Ihren Webbrowser und besuchen Sie Ihren MediaWiki-Domainnamen, z. B. http://wiki.howtoforge.local. Klicken Sie auf den Link Wiki einrichten, um mit der Installation zu beginnen.

Wählen Sie Ihre Sprache für MediaWiki aus und klicken Sie auf Weiter.

Klicken Sie auf Weiter, um die Bedingungen von MediaWiki zu akzeptieren.

Geben Sie Ihre MariaDB-Datenbankdetails ein und klicken Sie auf Weiter.

Für die Datenbankeinstellungen lassen Sie dies als Standard und klicken Sie auf Weiter.

Geben Sie jetzt Ihren Wiki-Titel ein und erstellen Sie einen neuen Admin-Benutzer und ein Passwort für Ihre MediaWiki-Installation. Klicken Sie dann erneut auf Weiter.

Gehen Sie zu den Skins-Optionen von MediaWiki und wählen Sie Ihr Standard-Skin/Thema aus. In diesem Beispiel verwenden wir MinervaNeue.

Scrollen Sie nach unten, lassen Sie die anderen Einstellungen (oder ändern Sie sie nach Bedarf) und klicken Sie auf Weiter.

Klicken Sie auf Weiter, um die Installation zu bestätigen.

Nachdem die Installation abgeschlossen ist, klicken Sie erneut auf Weiter.

Jetzt wird die Datei LocalSettings.php automatisch auf Ihren lokalen Computer heruntergeladen. Laden Sie diese Datei hoch oder erstellen Sie die Datei LocalSettings.php mit dem gleichen Inhalt, den Sie haben.

Ändern Sie in der Datei LocalSettings.php die Standardoption $wgDefaultSkin in minerva.

$wgDefaultSkin = "minerva";

Besuchen Sie jetzt Ihre MediaWiki-Startseite und Sie können die Startseite des MinervaNeue-Themes unten sehen.

Sie können jetzt auf die Schaltfläche „Anmelden“ oben rechts klicken und dann Ihren Admin-Benutzer und Ihr Passwort eingeben.

Fazit

Herzlichen Glückwunsch! Sie haben die Installation von MediaWiki auf dem Ubuntu 24.04-Server abgeschlossen. Sie haben MediaWiki mit dem LAMP-Stack (Linux, Apache, MySQL/MariaDB und PHP) und mit HTTPS über certbot und Letsencrypt gesichert.