Comment installer MediaWiki sur Ubuntu 24.04

MediaWiki est un logiciel wiki open-source écrit en PHP et MySQL. C’est un logiciel wiki évolutif et extensible qui alimente des sites comme Wikipedia et Wikimedia. MediaWiki peut être utilisé comme une plateforme de collaboration et de documentation. Il vous permet d’organiser la documentation et de la rendre publique pour tout le monde. Il prend en charge le multilingue et offre des options de personnalisation pour différents aspects, des thèmes/skins, des plugins et des éditeurs.

Ce guide vous montrera comment installer le logiciel MediaWiki sur un serveur Ubuntu 24.04. Vous installerez MediaWiki avec la pile LAMP (Linux, Apache, MySQL/MariaDB et PHP), puis vous le sécuriserez avec HTTPS via Certbot et Letsencrypt.

Prérequis

Avant de commencer, assurez-vous d’avoir les éléments suivants :

• Un serveur Ubuntu 24.04.
• Un utilisateur non-root avec des privilèges d’administrateur.
• Un nom de domaine pointant vers une adresse IP de serveur.

Installation des dépendances

Pour installer MediaWiki, vous devez vous assurer que les dépendances sont installées sur votre système. Actuellement, la version stable de MediaWiki 1.41 nécessite PHP 8.1-83. Dans cette section, vous installerez Apache, le serveur MariaDB, PHP 8.3 et ImageMagick comme dépendances pour MediaWiki.

Tout d’abord, exécutez la commande suivante pour mettre à jour votre dépôt Ubuntu.

sudo apt update

Maintenant, installez les dépendances pour MediaWiki en utilisant la commande suivante. Entrez Y pour confirmer le processus. Avec cela, vous installerez la pile LAMP (Apache, MySQL/MariaDB et PHP) et les paquets ImageMagick.

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

Après l’installation, vérifiez l’état du service apache2 avec la commande ci-dessous. Vous verrez que le serveur web Apache est en cours d’exécution et activé.

sudo systemctl is-enabled apache2
sudo systemctl status apache2

Vérifiez le service mariadb avec la commande suivante. Vous pouvez voir ci-dessous que le serveur MariaDB est en cours d’exécution et activé.

sudo systemctl is-enabled mariadb
sudo systemctl status mariadb

Enfin, vérifiez la version de PHP en utilisant la commande suivante. Vous verrez PHP 8.3 installé sur votre système.

sudo php -v

Configuration de UFW

Ajoutez et activez le profil Apache Full sur UFW avec ce qui suit :

sudo ufw allow “Apache Full”

Maintenant, vérifiez les règles activées dans UFW avec la commande ufw status ci-dessous. Le profil Apache Full ouvre des ports pour les protocoles HTTP et HTTPS.

sudo ufw status

Configuration de PHP

Après avoir installé les dépendances, vous allez configurer PHP en modifiant le fichier de configuration par défaut /etc/php/8.3/apache2/php.ini.

Exécutez la commande nano suivante pour ouvrir le fichier de configuration PHP /etc/php/8.3/apache2/php.ini.

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

Décommentez et modifiez la configuration PHP par défaut avec ce qui suit. Assurez-vous d’ajuster à la fois les options memory_limit et date.timezone selon vos besoins.

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

Enregistrez et quittez le fichier une fois terminé.

Maintenant, exécutez la commande ci-dessous pour redémarrer le serveur web Apache et appliquer votre configuration PHP.

sudo systemctl restart apache2

Configuration du serveur MariaDB

Maintenant que PHP est configuré, vous allez sécuriser le serveur MariaDB et créer une nouvelle base de données et un nouvel utilisateur pour MediaWiki. Vous allez sécuriser MariaDB avec l’utilitaire mariadb-secure-installation, puis créer une nouvelle base de données et un utilisateur via le client mariadb.

Sécurisez votre installation du serveur MariaDB avec la commande mariadb-secure-installation ci-dessous.

sudo mariadb-secure-installation

Maintenant, vous serez invité à configurer le serveur MariaDB comme suit :

• L’installation par défaut de MariaDB ne vient pas avec un mot de passe, appuyez sur ENTRER lorsque vous êtes invité pour le mot de passe.
• Maintenant, entrez Y pour configurer le mot de passe root de MariaDB. Ensuite, tapez le nouveau mot de passe pour MariaDB et répétez le mot de passe.
• Entrez Y pour supprimer l’utilisateur anonyme de votre installation MariaDB.
• Entrez Y à nouveau lorsque vous êtes invité à désactiver la connexion à distance pour l’utilisateur root de MariaDB.
• Entrez Y pour supprimer la base de données de test par défaut de votre MariaDB.
• Enfin, entrez Y pour recharger les privilèges des tables et appliquer les nouvelles modifications.

Après avoir sécurisé MariaDB, connectez-vous au serveur MariaDB avec ce qui suit - Entrez votre mot de passe root lorsque vous y êtes invité.

sudo mariadb -u root -p

Ensuite, exécutez les requêtes suivantes pour créer une nouvelle base de données et un utilisateur pour MediaWiki. Dans cet exemple, vous allez créer une nouvelle base de données mediawikidb, un utilisateur mediawiki avec le mot de passe mediawikipassdb. Vous pouvez ajuster les détails de la base de données avec vos informations.

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

Maintenant, exécutez la requête ci-dessous pour vérifier les privilèges de l’utilisateur mediawiki. Ci-dessous, vous pouvez voir que l’utilisateur mediawiki peut accéder à la base de données mediawikidb.

SHOW GRANTS FOR mediawiki@localhost;

Enfin, tapez quit pour quitter le serveur MariaDB.

Téléchargement de MediaWiki

Dans cette section, vous allez télécharger le code source de MediaWiki 1.41 et configurer le répertoire d’installation pour MediaWiki.

Allez dans le répertoire /var/www et téléchargez le code source de MediaWiki avec la commande curl ci-dessous. Assurez-vous de visiter la page de téléchargement de MediaWiki pour obtenir la dernière version.

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

Après le téléchargement, extrayez le code source de MediaWiki et renommez le répertoire en mediawiki. Avec cela, votre répertoire racine de documents pour MediaWiki devrait être disponible dans le répertoire /var/www/mediawiki.

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

Maintenant, changez la propriété du répertoire /var/www/mediawiki à l’utilisateur www-data et les permissions par défaut à 0755.

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

Configuration de l’hôte virtuel Apache

Maintenant que vous avez téléchargé le code source de MediaWiki, l’étape suivante consistera à créer un nouveau fichier d’hôte virtuel Apache pour exécuter MediaWiki. Assurez-vous d’avoir un nom de domaine pointant vers votre serveur MediaWiki.

Tout d’abord, exécutez la commande suivante pour activer le module rewrite sur le serveur web Apache.

sudo a2enmod rewrite

Maintenant, créez un nouveau fichier d’hôte virtuel /etc/apache2/sites-available/mediawiki.conf avec la commande de l’éditeur nano suivante.

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

Entrez la configuration suivante et assurez-vous de changer l’option ServerName avec votre nom de domaine.

  
  
 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  
   
  

Enregistrez et fermez le fichier lorsque vous avez terminé.

Ensuite, exécutez la commande ci-dessous pour activer le fichier d’hôte virtuel mediawiki.conf et vérifier votre syntaxe Apache. Si vous avez une syntaxe Apache correcte, vous obtiendrez une sortie Syntax is OK.

sudo a2ensite mediawiki.conf
sudo apachectl configtest

Enfin, exécutez la commande ci-dessous pour redémarrer Apache et appliquer vos modifications. Avec cela, votre installation de MediaWiki devrait être prête.

sudo systemctl restart apache2

Sécurisation de MediaWiki avec HTTPS

Dans ce guide, vous allez sécuriser MediaWiki avec HTTPS. Si vous utilisez un domaine public, vous pouvez utiliser des certificats SSL gratuits de Letsencrypt et configurer HTTPS automatiquement. Vous pouvez générer des certificats SSL et configurer HTTPS manuellement pour les utilisateurs de domaines locaux.

Installez les paquets certbot et python3-certbot-apache avec la commande suivante. Entrez Y pour confirmer l’installation.

sudo apt install certbot python3-certbot-apache

Après l’installation, exécutez la commande certbot ci-dessous pour générer des certificats SSL/TLS pour votre installation MediaWiki. Assurez-vous de changer l’adresse e-mail et le nom de domaine avec vos informations.

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

Vous verrez des certificats SSL/TLS dans le répertoire /etc/letsencrypt/live/domain.com. Votre installation de MediaWiki devrait être automatiquement sécurisée avec HTTPS.

Installation de MediaWiki

Ouvrez votre navigateur web et visitez votre nom de domaine MediaWiki tel que http://wiki.howtoforge.local. Cliquez sur le lien Configurer le wiki pour commencer l’installation.

Sélectionnez votre langue pour MediaWiki et cliquez sur Continuer.

Cliquez sur Continuer pour accepter les conditions de MediaWiki.

Entrez les détails de votre base de données MariaDB et cliquez sur Continuer.

Pour les paramètres de la base de données, laissez cela par défaut et cliquez sur Continuer.

Maintenant, entrez le titre de votre wiki et créez un nouvel utilisateur admin et un mot de passe pour votre installation MediaWiki. Ensuite, cliquez à nouveau sur Continuer.

Dans les options supplémentaires de MediaWiki, allez à la section Skins et sélectionnez votre skin/thème par défaut. Dans cet exemple, nous allons utiliser MinervaNeue.

Faites défiler vers le bas, laissez les autres paramètres (ou changez-les si nécessaire), puis cliquez sur Continuer.

Cliquez sur Continuer pour confirmer l’installation.

Après l’installation, cliquez à nouveau sur Continuer.

Maintenant, le fichier LocalSettings.php sera téléchargé automatiquement sur votre machine locale. Téléchargez ce fichier ou créez le fichier LocalSettings.php avec le même contenu que vous avez.

Dans le fichier LocalSettings.php, changez l’option par défaut $wgDefaultSkin en minerva.

$wgDefaultSkin = "minerva";

Maintenant, visitez votre page d’accueil MediaWiki et vous pouvez voir ci-dessous la page d’accueil du thème MinervaNeue.

Vous pouvez maintenant cliquer sur le bouton de connexion en haut à droite, puis entrer votre utilisateur admin et votre mot de passe.

Conclusion

Félicitations ! Vous avez terminé l’installation de MediaWiki sur le serveur Ubuntu 24.04. Vous avez MediaWiki fonctionnant avec la pile LAMP (Linux, Apache, MySQL/MariaDB et PHP) et sécurisé avec HTTPS via certbot et Letsencrypt.