Dernière version du 6 mai 2026 à 11:39

Alpine Linux

Installation dépendances

# apk update && apk upgrade
# apk add curl lighttpd php php-dom php-json php-pgsql php-cgi php-mbstring php-xml php-ctype php-fileinfo php-iconv php-zlib php-gd php-session php7-intl php7-pecl-apcu php7-mysqli php7-xmlreader php7-xmlwriter php7-pecl-memcached memcached git imagemagick diffutils mariadb mariadb-common mariadb-client

Configuration de MariaDB

On active le serveur :

# service mariadb setup
# rc-update add mariadb default
# service mariadb start

On sécurise MariaDB :

# mysql_secure_installation

Switch to unix_socket authentication [Y/n] y

Change the root password? [Y/n] y

Remove anonymous users? [Y/n] y

Disallow root login remotely? [Y/n] y

Remove test database and access to it? [Y/n] y

Reload privilege tables now? [Y/n] y
... Success!

On configure la base de donnée pour acceuillir MediaWiki :

# mysql -u root -p

MariaDB [(none)]> CREATE DATABASE mediawiki;
MariaDB [(none)]> CREATE USER 'mediawiki'@'localhost' IDENTIFIED BY 'monsupermotdepasse';
MariaDB [(none)]> GRANT ALL ON mediawiki.* TO 'mediawiki'@'localhost';
MariaDB [(none)]> quit;

Installation de MediaWiki

On récupère la dernière version à cette adresse et on place MediaWiki dans l'arborescence du serveur Web :

# wget https://releases.wikimedia.org/mediawiki/1.36/mediawiki-1.36.1.zip
# unzip mediawiki-1.36.1.zip
# mv mediawiki-1.36.1 /var/www/localhost/htdocs/mediawiki
# rm mediawiki-1.36.1.zip

On attribue les droits :

# chown -R lighttpd /var/www/localhost/htdocs/mediawiki

On édite la configuration de "lighttpd" pour activer "mod_fastcgi.conf" :

# vi /etc/lighttpd/lighttpd.conf

...
# uncomment for php/fastcgi support
   include "mod_fastcgi.conf"
# uncomment for php/fastcgi fpm support
...

A la fin de ce même fichier, on protège le dossier "images" de l'éxécution de scripts, par sécurité, en ajoutant :

...
$HTTP["url"] =~  "^/mediawiki/images/" {
    fastcgi.server = ()
}

On active memcached maintenant et au redemarrage :

 # service memcached start && rc-update add memcached default

On lance le serveur "lighttpd" immédiatement et au démarrage :

# service lighttpd start && rc-update add lighttpd default

Configuration de MediaWiki

On se rend à l'adresse "http://ADRESSE_IP_SERVEUR/mediawiki/mw-config/index.php" :

On configure l'environnement linguistique..

On vérifie que tous les prérequis sont satisfait :

Paramètre de la base de données :

On peut laisser par défaut cette option et continuer :

On configure le nom du Wiki et le compte administrateur, ici "admin" pour plus de simplicité :

La page suivante comporte de nombreuses options à régler à sa guise, en fin de page on active le téléversement des fichiers, "Instant Commons" et on active "memcached" :

On confirme que la configuration est terminée pour lancer l'installation :

Le script d'installation confirme que tout s'est déroulé comme prévu :

Le serveur vous envoie le fichier "LocalSettings.php" à placer dans "/var/www/localhost/htdocs/mediawiki/" :

Une méthode simple est de copier-coller le contenu du fichier :

# vi /var/www/localhost/htdocs/mediawiki/LocalSettings.php

Copier-Coller de LocalSettings.php

# chown lighttpd /var/www/localhost/htdocs/mediawiki/LocalSettings.php

Par sécurité on lance le redémarrage de l'installation pour effacer les options sélectionner et rendre le contenu de "LocalSettings.php" inaccessible :

On confirme l'effacement des données et l'installation est terminé :

Sécuriser lighttpd

On créé le certificat :

# apk update && apk upgrade
# apk add openssl
# openssl req -newkey rsa:2048 -x509 -keyout /etc/lighttpd/server.pem -out /etc/lighttpd/server.pem -days 365 -nodes
# chmod 400 /etc/lighttpd/server.pem

On édite la configuration du serveur :

# vi /etc/lighttpd/lighttpd.conf

...
server.modules = (
    "mod_openssl",
#    "mod_rewrite",
...

...
server.port             = 443
ssl.engine    = "enable"
ssl.pemfile   = "/etc/lighttpd/server.pem"

On relance le service :

# service lighttpd restart

On adapte le fichier "LocalSettings.php" :

# vi /var/www/localhost/htdocs/mediawiki/LocalSettings.php

...
## The protocol and server name to use in fully-qualified URLs
$wgServer = "https://ADRESSE_IP_SERVEUR";
...

Vhost Reverse-Proxy Nginx

Voir Reverse Proxy Nginx

server {
    listen 80;
    listen [::]:80;
    server_name     monwiki.exemple.net;
    return 301 https://$host$request_uri;
}

server {
    server_name     monwiki.exemple.net;

    client_max_body_size 50M;

    # protection
    add_header X-Content-Type-Options "nosniff" always;
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
    add_header Permissions-Policy "geolocation=(), microphone=(), camera=()" always;
    add_header Strict-Transport-Security "max-age=31536000" always;

    location / {
        proxy_set_header Host              $host;
        proxy_set_header X-Real-IP         $remote_addr;
        proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-Host  $host;
        proxy_set_header X-Forwarded-Port  $server_port;

        proxy_pass https://ADRESSE_IP_SERVEUR/mediawiki/;
    }

    listen [::]:443 ssl; # managed by Certbot
    listen 443 ssl; # managed by Certbot

    ssl_certificate /etc/letsencrypt/live/monwiki.exemple.net/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/monwiki.exemple.net/privkey.pem;
    include /etc/letsencrypt/options-ssl-nginx.conf;

}

On adapte le fichier "LocalSettings.php" :

# vi /var/www/localhost/htdocs/mediawiki/LocalSettings.php

...
#$wgScriptPath = "/mediawiki";                                                                                                                                                                                                                                                                                                                      
$wgScriptPath = "";
...

...
## The protocol and server name to use in fully-qualified URLs
$wgServer = "https://monwiki.exemple.net";
...

Mettre à jour MediWiki

Penser à sauvegarder votre wiki avant la mise à jour..

Source

Alpine Linux

Exemple sur Alpine Linux fait de la version 1.35.1 à la version 1.36.1

On récupère la nouvelle version :

# cd /usr/share/webapps/
# wget https://releases.wikimedia.org/mediawiki/1.36/mediawiki-1.36.1.zip
# unzip mediawiki-1.36.1.zip
# rm mediawiki-1.36.1.zip

On attribue les droits :

# chown -R lighttpd mediawiki-1.36.1

On récupère le "LocalSettings.php" :

# cp -rp mediawiki-1.35.1/LocalSettings.php mediawiki-1.36.1/

On récupère le dossier "images" :

# cp -rp mediawiki-1.35.1/images mediawiki-1.36.1/

(Optionnel) On installe la version 1.36 de "TemplateStyles" :

# wget https://extdist.wmflabs.org/dist/extensions/TemplateStyles-REL1_36-e548bf1.tar.gz
# tar -xzf TemplateStyles-REL1_36-e548bf1.tar.gz -C /usr/share/webapps/mediawiki-1.36.1/extensions/
# chown -R lighttpd /usr/share/webapps/mediawiki-1.36.1/extensions/TemplateStyles
# rm TemplateStyles-REL1_36-e548bf1.tar.gz

(Optionnel) On installe la version 1.36 de "Scribunto" :

# wget https://extdist.wmflabs.org/dist/extensions/Scribunto-REL1_36-ac71012.tar.gz
# tar -xzf Scribunto-REL1_36-ac71012.tar.gz -C /usr/share/webapps/mediawiki-1.36.1/extensions/
# chown -R lighttpd /usr/share/webapps/mediawiki-1.36.1/extensions/Scribunto
# rm Scribunto-REL1_36-ac71012.tar.gz

(Optionnel) On récupère son logo :

# cp -rp /usr/share/webapps/mediawiki-1.35.1/skins/common/images/logo.png /usr/share/webapps/mediawiki-1.36.1/images/logo.png

Les chemins peuvent varier selon la version et vos choix antérieur..

Dans cette exemple il faut adapter votre "LocalSettings.php" avec $wgLogo = "$wgScriptPath/images/logo.png";

Ensuite il faut mettre a jour la base de données :

# php /usr/share/webapps/mediawiki-1.36.1/maintenance/update.php

On remplace le lien symbolique de l'ancien wiki par le nouveau :

# rm /var/www/localhost/htdocs/mediawiki
# ln -s /usr/share/webapps/mediawiki-1.36.1 /var/www/localhost/htdocs/mediawiki

Une fois vérifié que tout fonctionne on peut supprimer l'ancienne version :

# rm -r /usr/share/webapps/mediawiki-1.35.1

Transférer MediaWiki

Sauvegarde

Dans cet exemple les répertoires correspondent à une sauvegarde sur Debian.

Sur l'ancien serveur on commence par saugarder les fichiers :

ancienwiki:~# tar zcvhf /var/www/mediawiki.tgz /var/www/mediawiki

Ensuite on sauvegarde la base de données :

ancienwiki:~# mysqldump -u mediawiki -p mediawiki > /var/www/mediawiki.sql

Le mot de passe de l'utilisateur "mediawiki" (visible dans "LocalSettings.php") sera éxigé.

Transfert des fichiers

Dans cet exemple on transfert les fichiers de Debian à Alpine Linux, notez que pour utiliser SCP sur Alpine il faudra installer un serveur SSH

Depuis l'ancien serveur :

ancienwiki:~# scp /var/www/mediawiki.tgz  IP_NOUVEAU_SERVEUR:/var/www/localhost/htdocs/
ancienwiki:~# scp /var/www/mediawiki.sql  IP_NOUVEAU_SERVEUR:/var/www/localhost/htdocs/

Restauration

Sur le nouveau serveur, on commence par restaurer les fichiers :

nouveauwiki:~# cd /var/www/localhost/htdocs/
nouveauwiki:~# tar -xvzf mediawiki.tgz
nouveauwiki:~# mv var/www/mediawiki ./
nouveauwiki:~# rm -r var

On attribue les droits :

nouveauwiki:~# chown -R lighttpd:root mediawiki

Puis on restaure la base de données du wiki :

nouveauwiki:~# mysql -u mediawiki -p mediawiki < /var/www/localhost/htdocs/mediawiki.sql

Le mot de passe de l'utilisateur "mediawiki" (visible dans "LocalSettings.php") sera éxigé.

Il faudra probablement adapter "LocalSettings.php", une fois terminé il est possible de supprimer les fichiers transférés :

nouveauwiki:~# rm /var/www/localhost/htdocs/mediawiki.tgz
nouveauwiki:~# rm /var/www/localhost/htdocs/mediawiki.sql

Erreur LUA

Lua error: Internal error: The interpreter exited with status 127.

# apk add lua
# service lighttpd restart
# vi /var/www/localhost/htdocs/mediawiki/LocalSettings.php

..
$wgScribuntoDefaultEngine = 'luastandalone';                
$wgScribuntoEngineConf['luastandalone']['luaPath'] = '/usr/bin/lua';
..

Import de fonctions

Section en partie rédigé sous Debian.

Chemin sous Debian: /var/www/mediawiki

Chemin sous Alpine Linux: /var/www/localhost/htdocs/mediawiki

Source utile

Réglages de base

Activer Uploads & ImageMagick

# vi /var/www/mediawiki/LocalSettings.php

$wgEnableUploads = true;
$wgUseImageMagick = true;
$wgImageMagickConvertCommand = "/usr/bin/convert";

# apt install imagemagick

Pour régler la taille maximale des importations de fichiers, il faut configurer le service PHP local et le reverse proxy s’il est utilisé.

Exemple avec une limite de 50 Mo et PHP 8.3 :

# vi /etc/php83/php.ini

Et on modifie :

...
upload_max_filesize = 50M
...
post_max_size = 60M
...

# rc-service php-fpm83 restart

Activer "IstantCommons

source

# vi /var/www/mediawiki/LocalSettings.php

$wgUseInstantCommons = true;

CSS Wikipedia

Se connecter sur son Wiki (avec droit d'éditiont)
Se rendre à l'adresse "https://mon-mediawiki.com/index.php?title=MediaWiki:Common.css"
cliquer sur "Edit" et remplacer par ce code-ci!
Il faudra vider le cache de son navigateur / recharger avec Ctrl + F5

Installation extension "TemplateStyles"

source

# cd /tmp/
# wget https://extdist.wmflabs.org/dist/extensions/TemplateStyles-REL1_35-7a40a6a.tar.gz
# tar -xzf TemplateStyles-REL1_35-7a40a6a.tar.gz -C /var/www/mediawiki/extensions
# chown -R www-data. /var/www/mediawiki/extensions/TemplateStyles
# echo 'wfLoadExtension( 'TemplateStyles' );' >> /var/www/mediawiki/LocalSettings.php

Installation extension "Scribunto"

Source

# cd /tmp/
# wget https://extdist.wmflabs.org/dist/extensions/Scribunto-REL1_35-d21b655.tar.gz
# tar -xzf Scribunto-REL1_35-d21b655.tar.gz -C /var/www/mediawiki/extensions/Scribunto/
# chown -R www-data. /var/www/mediawiki/extensions/Scribunto
# echo 'wfLoadExtension( 'Scribunto' );' >> /var/www/mediawiki/LocalSettings.php
# echo '$wgScribuntoDefaultEngine = 'luastandalone';' >> /var/www/mediawiki/LocalSettings.php
# chmod a+x /var/www/mediawiki/extensions/Scribunto/includes/engines/LuaStandalone/binaries/lua5_1_5_linux_64_generic/lua

Pour Alpine Linux et autre voir Error status 127

Activer "ParserFunctions"

# echo 'wfLoadExtension( 'ParserFunctions' );' >> /var/www/mediawiki/LocalSettings.php
# echo '$wgPFEnableStringFunctions = true;' >> /var/www/mediawiki/LocalSettings.php

Extension MobileFrontend

On télécharge l'extension :

# cd /var/www/localhost/htdocs/mediawiki/extensions/
# git clone --branch REL1_45 https://gerrit.wikimedia.org/r/mediawiki/extensions/MobileFrontend

REL1_45 en fonction de la version de MediaWiki installée, ici la 1.45.x .

On édite le fichier de configuration :

# vi /var/www/localhost/htdocs/mediawiki/LocalSettings.php

Ajouter à la fin du fichier :

...
wfLoadSkin( 'MinervaNeue' );
wfLoadExtension( 'MobileFrontend' );
$wgDefaultMobileSkin = 'minerva';
$wgMFAutodetectMobileView = true;

Exemple Serveur Wikipedia et barre de progression

100 % la preuve par l'exemple!

Export chez Wikipedia

Page d'export soit "/Spécial:Exporter"

J'ai exporté les modèles suivant :

Modèle:Progression
Modèle:0/4
Modèle:1/4
Modèle:2/4
Modèle:3/4
Modèle:4/4
Modèle:Avancement
Modèle:Barre de progression

Import sur son wiki

Allez sur la page spécial "Importer des pages" soit "/Special:Import"

Erreur "The content model 'sanitized-css' is not registered on this wiki."

Échec de l’importation : The content model 'sanitized-css' is not registered on this wiki. See https://www.mediawiki.org/wiki/Content_handlers to find out which extensions handle this content model.

Installer l'extension "TemplateStyles"

Erreur "The content model 'Scribunto' is not registered on this wiki."

Échec de l’importation : The content model 'Scribunto' is not registered on this wiki. See https://www.mediawiki.org/wiki/Content_handlers to find out which extensions handle this content model.

Installer l'extension "Scribunto"

(erreur d'affichage "{{#expr".. etc)

Activer "ParserFunctions"

Bandeau d'information/avertissement

ça semble fonctionner :)))

J'ai exporté tous les modules "Lua" via cette page.

Module:Format
Module:Date
Module:MagicDate
Module:Test
Module:ControlArgs
Module:Documentation module
Module:Bandeau

Puis ces modèles :

Modèle:Méta bandeau
Modèle:Méta bandeau d'avertissement
Modèle:Méta bandeau de section

Astuces de personnalisation

Source

Nom du Wiki

# vi /var/www/mediawiki/LocalSettings.php

$wgSitename = "Le nom de mon Wiki";

Logo

La taille du logo en pixels doit être de 135x135

Il faut placer son logo dans "/var/www/mediawiki/skins/common/images/"

# mkdir -p /var/www/mediawiki/skins/common/images

On copie son image (ex: logo.png) dans /var/www/mediawiki/skins/common/images/

# chown -R www-data. /var/www/mediawiki/skins/common
# vi /var/www/mediawiki/LocalSettings.php

...
$wgLogo = "/skins/common/images/logo.png";
...

Edition disponible uniquement pour les utilisateur authentifiés

# echo '$wgGroupPermissions['*']['edit'] = false;' >> /var/www/mediawiki/LocalSettings.php

Skin

Citizen

Citizen est un habillage MediaWiki beau, pratique et adaptatif, qui intègre les extensions dans une expérience cohérente. Il a été créé à l’origine pour le wiki de Star Citizen, mais il est suffisamment souple pour fonctionner sur différentes configurations de MediaWiki.

Installation :

# cd /var/www/localhost/htdocs/mediawiki/skins/
# wget <nowiki>https://<nowiki>github.com/StarCitizenTools/mediawiki-skins-Citizen/archive/main.zip
# unzip main.zip
# mv mediawiki-skins-Citizen-main Citizen
# chown -R root:root Citizen
# find Citizen -type d -exec chmod 755 {} \;
# find Citizen -type f -exec chmod 644 {} \;

Puis, on édite le fichier de configuration :

# vi /var/www/localhost/htdocs/mediawiki/LocalSettings.php

On ajoute ou modifie :

$wgDefaultSkin = "Citizen";

wfLoadSkin( 'Citizen' );

On peut évidemment commenter les autres skins pour être sûr de mieux contrôler l’expérience utilisateur.

Et si MobileFrontend est installé (ce que je déconseille avec ce skin) :

$wgDefaultMobileSkin = 'citizen';

Configuration :

Voir ce lien.

Dossier temporaire dédié pour contourner restriction LXC

mkdir -p /var/www/localhost/htdocs/mediawiki/tmp
chown -R lighttpd:lighttpd /var/www/localhost/htdocs/mediawiki/tmp
chmod 2775 /var/www/localhost/htdocs/mediawiki/tmp

Dans LocalSettings.php, ajoute :

vi /var/www/localhost/htdocs/mediawiki/LocalSettings.php

...
$wgTmpDirectory = "/var/www/localhost/htdocs/mediawiki/tmp";