Comment installer MediaWiki sur Ubuntu 24.04

Ce tutoriel existe pour ces versions d'OS

• Ubuntu 24.04 (Noble Numbat)
• Ubuntu 22.04 (Jammy Méduse)
• Ubuntu 18.04 (Castor Bionic)

Sur cette page

1. Conditions préalables
2. Installation des dépendances
3. Configuration d'UFW
4. Configuration de PHP
5. Configuration du serveur MariaDB
6. Téléchargement de MediaWiki
7. Configuration de l'hôte virtuel Apache
8. Sécuriser MediaWiki avec HTTPS
9. Installation de MediaWiki
10. Conclusion

MediaWiki est un logiciel wiki open source écrit en PHP et MySQL. Il s'agit de sites wiki évolutifs et extensibles tels que Wikipédia et Wikimédia. MediaWiki peut être utilisé comme plateforme de collaboration et de documentation. Il vous permet d'organiser la documentation et de la rendre publique à tous. Il prend en charge le multilingue et offre une personnalisation pour différents aspects, depuis les thèmes/skins, les plugins et les éditeurs.

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

Conditions préalables

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 pointait 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 en tant que dépendances pour MediaWiki.

Tout d'abord, exécutez la commande suivante pour mettre à jour votre référentiel Ubuntu.

sudo apt mise à jour

Maintenant, installez les dépendances pour MediaWiki à l'aide de la commande suivante. Entrez Y pour confirmer le processus. Avec cela, vous installerez les packages LAMP Stack (Apache, MySQL/MariaDB et PHP) et 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

Une fois l'installation terminée, 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 est activé pour 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 est activé mariadb
sudo systemctl status mariadb

Enfin, vérifiez la version PHP à l'aide de la commande suivante. Vous verrez PHP 8.3 installé sur votre système.

sudo php -v

Configuration d'UFW

Ajoutez et activez le profil Apache Full sur UFW avec les éléments suivants :

sudo ufw autorise "Apache Full"

Vérifiez maintenant 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.

statut sudo ufw

Configuration de PHP

Après avoir installé les dépendances, vous configurerez PHP en éditant 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 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 lorsque vous avez terminé.

Exécutez maintenant la commande ci-dessous pour redémarrer le serveur Web Apache et appliquer votre configuration PHP.

sudo systemctl redémarrer 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 sécuriserez MariaDB avec l'utilitaire mariadb-secure-installation, puis créerez une nouvelle base de données et un nouvel utilisateur via le client mariadb.

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

sudo mariadb-secure-installation

Il vous sera maintenant demandé les configurations de serveur MariaDB suivantes :

• L'installation par défaut de MariaDB est livrée sans mot de passe, appuyez sur ENTRÉE lorsque vous êtes invité à saisir le mot de passe.
• Saisissez maintenant Y pour configurer le mot de passe root MariaDB. Ensuite, tapez le nouveau mot de passe pour MariaDB et répétez le mot de passe.
• Saisissez Y pour supprimer l'utilisateur anonyme de votre installation MariaDB.
• Saisissez à nouveau Y lorsque vous êtes invité à désactiver la connexion à distance pour l'utilisateur root MariaDB.
• Saisissez Y pour supprimer le test de base de données par défaut de votre MariaDB.
• Enfin, saisissez Y pour recharger les privilèges de la table et appliquer les nouvelles modifications.

Une fois MariaDB sécurisée, connectez-vous au serveur MariaDB avec ce qui suit : Entrez votre mot de passe root lorsque vous y êtes invité.

sudo mariadb -u racine -p

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

CRÉER UNE BASE DE DONNÉES mediawikidb;
CRÉER UN UTILISATEUR mediawiki@localhost IDENTIFIÉ PAR 'mediawikipassdb';
ACCORDER TOUT SUR mediawikidb.* À mediawiki@localhost AVEC OPTION D'ACCORD;
FLUSH PRIVILEGES;

Exécutez maintenant 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.

AFFICHER LES SUBVENTIONS POUR 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 de MediaWiki.

Accédez au répertoire /var/www et téléchargez le code source MediaWiki avec la commande curl ci-dessous. Assurez-vous de visiter la page de téléchargement 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 MediaWiki et renommez le répertoire en mediawiki. Avec cela, le répertoire racine de vos 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 en utilisateur www-data et l'autorisation par défaut en 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 hôte virtuel Apache pour exécuter MediaWiki. Assurez-vous d'avoir un nom de domaine pointé vers votre serveur MediaWiki.

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

réécriture sudo a2enmod

Créez maintenant un nouveau fichier hôte virtuel /etc/apache2/sites-available/mediawiki.conf avec la commande d'éditeur nano suivante.

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

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

<VirtualHost *:80>
 ServerName wiki.howtoforge.local
 ServerAdmin [email 
 DocumentRoot /var/www/mediawiki
 ErrorLog /var/log/apache2/wiki.howtoforge.local_error.log
 CustomLog /var/log/apache2/wiki.howtoforge.local_access.log combined
 <Directory /var/www/mediawiki/>
 Options FollowSymlinks
 AllowOverride All
 Require all granted
 </Directory>
</VirtualHost>

Enregistrez et fermez le fichier lorsque vous avez terminé.

Ensuite, exécutez la commande ci-dessous pour activer le fichier hôte virtuel mediawiki.conf et vérifiez votre syntaxe Apache. Si vous disposez d'une syntaxe Apache appropriée, vous obtiendrez un résultat La syntaxe est 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 MediaWiki devrait être prête.

sudo systemctl redémarrer apache2

Sécuriser MediaWiki avec HTTPS

Dans ce guide, vous sécuriserez MediaWiki avec HTTPS. Si vous utilisez le domaine public, vous pouvez utiliser les certificats SSL gratuits de Letsencrypt et configurer automatiquement HTTPS. Vous pouvez générer des certificats SSL et configurer HTTPS manuellement pour les utilisateurs du domaine local.

Installez les packages certbot et python3-certbot-apache avec la commande suivante. Saisissez Y pour confirmer l'installation.

sudo apt installer certbot python3-certbot-apache

Une fois l'installation terminée, exécutez la commande certbot ci-dessous pour générer des certificats SSL/TLS pour votre installation MediaWiki. Assurez-vous de modifier l'adresse e-mail et le nom de domaine avec vos informations.

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

Vous verrez les certificats SSL/TLS dans le répertoire /etc/letsencrypt/live/domain.com. Votre installation MediaWiki devrait automatiquement être 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 démarrer l'installation.

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

Cliquez sur Continuer pour accepter les conditions de MediaWiki.

Saisissez 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-les par défaut et cliquez sur Continuer.

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

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

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

Cliquez sur Continuer pour confirmer l'installation.

Une fois l'installation terminée, 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.

Dans le fichier LocalSettings.php, remplacez l'option par défaut $wgDefaultSkin par minerva.

$wgDefaultSkin = “minerva”;

Visitez maintenant votre page d'accueil MediaWiki et vous pourrez voir ci-dessous la page d'accueil du thème MinervaNeue.

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

Conclusion

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