Comment installer DokuWiki sur Debian 12

DokuWiki est un logiciel wiki open-source simple et polyvalent qui ne nécessite pas de base de données. Il est connu pour sa facilité de maintenance, sa lisibilité et sa gestion des utilisateurs, ce qui le rend idéal pour créer et gérer de la documentation dans des environnements d’entreprise ou collaboratifs. Alimenté par PHP, son logiciel wiki polyvalent et son support intégré des contrôles d’accès (ACL) prennent en charge les principaux pilotes d’authentification. DokuWiki offre une administration facile, il est simple à installer, à maintenir et à sauvegarder d’un hôte à un autre.

Dans ce guide, nous vous guiderons à travers l’installation de DokuWiki sur le serveur Debian 12. Vous installerez DokuWiki avec la pile LAMP (Apache2, MariaDB et PHP), UFW et des certificats SSL/TLS via Letsencrypt.

Prérequis

Assurez-vous d’avoir ce qui suit pour procéder avec ce guide :

Un serveur Debian 12.
Un utilisateur non-root avec des privilèges d’administrateur.
Un nom de domaine pointé vers l’adresse IP du serveur.

Installation des dépendances

Par défaut, le paquet DokuWiki est disponible dans le dépôt Debian. Mais, pour vous assurer que vous avez la dernière version de DokuWiki installée, vous allez installer DokuWiki manuellement sur votre serveur Debian.

Dans cette section, vous installerez les dépendances pour DokuWiki, y compris les paquets de la pile LAMP (Apache2, MariaDB et PHP), UFW et Certbot.

Avant de commencer, mettez à jour votre dépôt Debian en utilisant la commande ci-dessous.

sudo apt update

Installez la pile LAMP, UFW et les paquets Certbot en utilisant la commande d’installation apt suivante. Tapez Y et appuyez sur ENTRÉE lorsque vous y êtes invité.

sudo apt install apache2 mariadb-server php libapache2-mod-php php-xml php-mbstring php-zip php-intl php-gd ufw certbot python3-certbot-apache

install deps

Une fois l’installation terminée, vérifiez l’état des services Apache et MariaDB pour vous assurer que le service fonctionne.

Exécutez la commande suivante pour vérifier le service apache2.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Lorsque apache2 fonctionne, vous devriez obtenir une sortie ‘active (en cours d’exécution)’. Et la sortie ‘enabled’ confirme qu’apache2 démarrera au démarrage du système.

verify apache2

Maintenant, exécutez la commande suivante pour vérifier le service mariadb.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Assurez-vous que le service mariadb est ‘enabled’ et ‘active (en cours d’exécution)’ sur votre machine Debian.

verify mariadb

Configuration de UFW

Dans ce guide, vous allez sécuriser votre serveur Debian avec UFW (Uncomplicated Firewall). Dans ce cas, vous devez ouvrir le port SSH pour votre accès à distance, et les ports pour les protocoles HTTP et HTTPS pour exécuter l’installation de DokuWiki.

Exécutez la commande suivante pour ajouter les profils OpenSSH et ‘WWW Full‘ à UFW.

Le profil OpenSSH ouvrira le port SSH par défaut 22, tandis que le profil ‘WWW Full’ ouvre les ports HTTP et HTTPS.

sudo ufw allow OpenSSH  
sudo ufw allow 'WWW Full'

Maintenant, exécutez la commande suivante pour démarrer et activer UFW sur votre machine Debian.

sudo ufw enable

Entrez y lorsque vous êtes invité à confirmer, et vous devriez obtenir une sortie telle que ‘Le pare-feu est actif et activé au démarrage du système‘. UFW sera exécuté automatiquement au démarrage du système.

setup ufw

Enfin, exécutez la commande suivante pour vérifier l’état de UFW. Assurez-vous que les profils OpenSSH et ‘WWW Full’ sont répertoriés dans vos règles UFW activées.

sudo ufw status

verify ufw

Configuration de php.ini

Dans la section suivante, vous allez configurer PHP en modifiant le fichier php.ini par défaut et en ajustant certaines des configurations pour l’installation de DokuWiki.

Exécutez la commande de l’éditeur nano suivante pour ouvrir le fichier de configuration PHP ‘/etc/php/8.2/apache2/php.ini‘.

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

Changez la configuration par défaut avec ce qui suit. Assurez-vous d’ajuster le paramètre memory_limit avec votre RAM actuelle du serveur.

memory_limit=256M  
upload_max_filesize=32M  
post_max_size=32M  
max_execution_time=60

Enregistrez et fermez le fichier une fois terminé.

Maintenant, exécutez la commande systemctl ci-dessous pour redémarrer le service apache2 et prendre en compte vos modifications.

sudo systemctl restart apache2

Configuration du serveur MariaDB

Maintenant que vous avez configuré PHP, l’étape suivante consiste à configurer votre installation de serveur MariaDB, puis à créer une nouvelle base de données et un utilisateur qui utiliseront DokuWiki.

Commencez le processus de configuration de MariaDB en exécutant la commande mariadb-secure-installation ci-dessous.

sudo mariadb-secure-installation

Entrez Y lorsque vous êtes invité à appliquer la nouvelle configuration à MariaDB, ou vous pouvez également taper n pour Non pour la rejeter. Voici quelques-unes des configurations de MariaDB que vous serez invité à effectuer :

L’installation par défaut de MariaDB se fait sans mot de passe, appuyez sur ENTRÉE 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 de table et appliquer les nouvelles modifications.

Après la configuration de MariaDB, vous devez créer une nouvelle base de données et un utilisateur qui seront utilisés par DokuWiki.

Connectez-vous au serveur MariaDB en exécutant la commande mariadb ci-dessous. Entrez votre mot de passe root de MariaDB lorsque vous y êtes invité.

sudo mariadb -u root -p

Maintenant, exécutez les requêtes suivantes pour créer une nouvelle base de données dokuwikidb, un utilisateur dokuwiki, avec le mot de passe ‘p4ssword‘. Assurez-vous de changer le mot de passe avec votre nouveau mot de passe.

CREATE DATABASE dokuwikidb;  
CREATE USER dokuwiki@localhost IDENTIFIED BY 'p4ssword';  
GRANT ALL PRIVILEGES ON dokuwikidb.* TO dokuwiki@localhost;  
FLUSH PRIVILEGES;

create database user

Ensuite, vérifiez l’utilisateur dokuwiki pour vous assurer des privilèges sur la base de données dokuwikidb.

SHOW GRANTS FOR dokuwiki@localhost;

Dans la sortie suivante, vous avez configuré l’utilisateur dokuwiki avec tous les privilèges pour la base de données dokuwikidb.

show dtabase user

Enfin, tapez quit pour quitter le serveur MariaDB et passer à l’étape suivante.

Téléchargement du code source de DokuWiki

Dans cette section, vous allez télécharger le code source de DokuWiki et configurer le répertoire d’installation avec les permissions appropriées.

Déplacez-vous dans le répertoire /var/www/ et téléchargez la dernière version stable de DokuWiki en utilisant la commande wget ci-dessous.

cd /var/www/  
wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz

Maintenant, extrayez le fichier dokuwiki-stable.tgz et renommez le répertoire extrait en dokuwiki. Cela signifie que votre répertoire d’installation de DokuWiki sera disponible à /var/www/dokuwiki.

tar xzvf dokuwiki-stable.tgz  
sudo mv dokuwiki-*a dokuwiki

Enfin, exécutez la commande ci-dessous pour changer la propriété du répertoire /var/www/dokuwiki à l’utilisateur www-data et au groupe www-data. De cette façon, votre serveur web Apache2 pourra lire le code source de DokuWiki.

sudo chown -R www-data:www-data /var/www/dokuwiki

Configuration de l’hôte virtuel Apache2

Après avoir téléchargé DokuWiki, vous allez maintenant créer un nouveau fichier d’hôte virtuel Apache2 pour exécuter DokuWiki. Assurez-vous que votre nom de domaine est prêt avant de commencer. Dans cet exemple, nous utiliserons le domaine wiki.howtoforge.local.

Maintenant, exécutez la commande de l’éditeur nano ci-dessous pour créer une nouvelle configuration d’hôte virtuel Apache2 /etc/apache2/sites-available/dokuwiki.conf.

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

Insérez la configuration suivante et assurez-vous de changer le nom de domaine wiki.howtoforge.local avec votre domaine.

  
    ServerName    wiki.howtoforge.local        
    DocumentRoot  /var/www/dokuwiki  
  
      
          
            AllowOverride All  
            Require all denied  
          
          
            Order allow,deny  
            Deny from all  
          
      
  
    ErrorLog   /var/log/apache2/wiki.howtoforge.local_error.log  
    CustomLog  /var/log/apache2/wiki.howtoforge.local_access.log combined

Lorsque vous avez terminé, enregistrez et fermez le fichier.

Ensuite, exécutez la commande suivante pour activer l’hôte virtuel dokuwiki.conf et vérifier votre syntaxe Apache pour vous assurer qu’il n’y a pas d’erreur.

sudo a2ensite dokuwiki.conf  
sudo apachectl configtest

Si vous avez une syntaxe correcte et qu’il n’y a pas d’erreur, vous verrez une sortie ‘Syntaxe OK‘.

setup apache2

Enfin, exécutez la commande ci-dessous pour redémarrer le serveur Apache2 et appliquer vos modifications.

sudo systemctl restart apache2

Sécurisation de DokuWiki avec des certificats SSL/TLS

À ce stade, votre DokuWiki fonctionne et est accessible. Mais pour vous assurer que votre installation est sécurisée, vous allez configurer des certificats SSL/TLS via Letsencrypt.

Exécutez la commande certbot ci-dessous pour générer des certificats SSL/TLS pour votre nom de domaine DokuWiki. 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

Une fois le processus terminé, votre installation de DokuWiki devrait être automatiquement configurée avec HTTPS. Et vos certificats SSL/TLS devraient être disponibles dans le répertoire /etc/letsencrypt/live/yourdomain.com.

Installation de DokuWiki via l’installateur Web

Ouvrez votre navigateur web et visitez votre nom de domaine pour l’installation de DokuWiki, tel que https:/wiki.howtoforge.local/install.php. Vous devriez voir l’installateur web de DokuWiki.

Sélectionnez l’option Activer ACL, saisissez votre utilisateur admin, votre e-mail et votre mot de passe pour DokuWiki, puis cliquez sur Enregistrer.

install dokuwiki

Une fois l’installation réussie, vous devriez obtenir une sortie ‘La configuration a été terminée avec succès.‘.

installation finished

Maintenant, revenez à votre terminal et supprimez le script install.php en utilisant la commande ci-dessous.

sudo rm /var/www/dokuwiki/install.php

Ensuite, cliquez sur le lien ‘votre nouveau DokuWiki‘ pour continuer. Et vous devriez obtenir la page d’accueil de DokuWiki comme suit.

dokuwiki homepage

Maintenant, cliquez sur le bouton Connexion et vous devriez obtenir la page de connexion DokuWiki comme suit.

Entrez votre utilisateur admin et votre mot de passe, puis cliquez sur Connexion. En cas de succès, vous devriez être présenté avec le tableau de bord DokuWiki.

dockuwiki dashboard

Conclusion

Félicitations ! Vous avez maintenant terminé l’installation de DokuWiki sur le serveur Debian 12. Vous avez installé DokuWiki avec la pile LAMP (Apache2, MariaDB et PHP). Vous avez également sécurisé votre installation de DokuWiki avec UFW (Uncomplicated Firewall) et des certificats SSL/TLS de Letsencrypt.