Comment installer Matomo Web Analytics sur Debian 12

Matomo, anciennement Piwik, est un logiciel d’analyse web gratuit et open-source qui peut être utilisé pour suivre les visites de sites web et afficher des rapports pour l’analyse des données et du public. Matomo est sous licence GPL, écrit en PHP, et peut fonctionner avec un serveur de base de données MySQL ou MariaDB.

Matomo fournit des rapports perspicaces pour le suivi des utilisateurs sur vos sites web. Cela inclut le moteur de recherche référent et les mots-clés, les langues, les visites de pages, les téléchargements de fichiers par les visiteurs, et plus encore. Matomo est devenu de plus en plus populaire comme alternative aux services d’analyse tels que Google Analytics.

Dans ce tutoriel, vous apprendrez à installer Matomo Web Analytics sur le serveur Debian 12. Vous configurerez Matomo avec la pile LAMP et sécuriserez Matomo avec HTTPS via Certbot et Letsencrypt.

Prérequis

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

Un serveur Debian 12.
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

Matomo est une analyse web basée sur PHP qui utilise MySQL/MariaDB comme base de données. Pour installer Matomo, vous devez installer la pile LAMP (Linux, Apache, MySQL/MariaDB et PHP) ou LEMP (Linux, Nginx, MySQL/MariaDB et PHP-FPM) sur votre système. Dans cet exemple, vous exécuterez Matomo avec la pile LAMP sur le serveur Debian.

Tout d’abord, exécutez la commande apt ci-dessous pour mettre à jour votre index de paquets Debian.

sudo apt update

Maintenant, installez les paquets de la pile LAMP (Linux, Apache, MySQL/MariaDB et PHP) avec la commande suivante :

sudo apt install apache2 mariadb-server php php-cli libapache2-mod-php php-common php-curl php-gd php-mbstring php-mysql php-xml php-intl php-zip wget unzip

Entrez Y pour confirmer l’installation.

install deps

Après l’installation, vérifiez l’état du serveur MariaDB avec la commande ci-dessous. Vous verrez le serveur MariaDB avec le statut actif (en cours d’exécution) et activé.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

check mariadb

Maintenant, vérifiez l’état du service Apache avec la commande suivante. Dans la sortie suivante, vous pouvez voir que le serveur web Apache est en cours d’exécution.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

check apache

Enfin, exécutez la commande php ci-dessous pour vérifier la version de PHP. Vous verrez que PHP 8.3 est installé.

php -v

check php

Configuration de PHP

Après avoir installé la pile LAMP, vous configurerez l’installation de PHP en modifiant le fichier php.ini et en redémarrant le serveur web Apache.

Ouvrez la configuration PHP par défaut /etc/php/8.3/apache2/php.ini avec l’éditeur nano suivant.

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

Changez la configuration par défaut comme suit - Assurez-vous de modifier à la fois les options date.timezone et memory_limit avec votre environnement serveur actuel.

date.timezone = Europe/Stockholm  
memory_limit = 256M  
upload_max_filesize = 16M  
max_execution_time = 300

Enregistrez le fichier et quittez l’éditeur.

Maintenant, exécutez la commande systemctl ci-dessous pour redémarrer le serveur web Apache et appliquer vos modifications à PHP.

sudo systemctl restart apache2

Configuration du serveur MariaDB

Dans cette section, vous sécuriserez le serveur MariaDB et définirez le mot de passe root pour celui-ci. Ensuite, vous créerez une nouvelle base de données et un utilisateur qui seront utilisés par Matomo.

Exécutez la commande mariadb-secure-installation ci-dessous pour sécuriser MariaDB et définir le mot de passe root.

sudo mariadb-secure-installation

Maintenant, vous serez interrogé sur les configurations suivantes :

Passer l’authentification locale à unix_socket ? Entrez n.
Configurer le nouveau mot de passe root de MariaDB. Entrez y pour confirmer, puis tapez le nouveau mot de passe pour votre déploiement de serveur MariaDB.
Supprimer l’utilisateur anonyme ? Entrez y pour confirmer.
Supprimer la base de données par défaut test du déploiement ? Entrez y pour confirmer.
Interdire la connexion root de MariaDB à partir de connexions distantes ? Entrez y pour confirmer.
Recharger les privilèges de table et appliquer les modifications ? Entrez y et appuyez sur ENTRÉE.

Ensuite, exécutez la commande mariadb ci-dessous pour vous connecter au serveur MariaDB. Entrez votre mot de passe root lorsqu’on vous le demande.

sudo mariadb -u root -p

Maintenant, exécutez les requêtes suivantes pour créer une nouvelle base de données et un utilisateur matomo avec le mot de passe p4ssword. Ajustez les détails de la base de données ci-dessous.

CREATE DATABASE matomo;  
CREATE USER 'matomo'@'localhost' IDENTIFIED BY 'p4ssword';  
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, INDEX, DROP, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES ON matomo.* TO 'matomo'@'localhost';  
FLUSH PRIVILEGES;

Enfin, exécutez la requête ci-dessous pour vérifier l’utilisateur matomo@localhost et quitter le serveur MariaDB. Cela garantira que l’utilisateur matomo@localhost peut accéder à la base de données matomo.

SHOW GRANTS FOR matomo@localhost;  
quit

check db user

Téléchargement du code source de Matomo

Maintenant que vous avez configuré PHP et créé une base de données et un utilisateur, vous pouvez installer Matomo. Maintenant, vous téléchargerez le code source de Matomo, configurerez le répertoire racine du document, puis changerez la propriété avec l’utilisateur Apache approprié.

Allez dans le répertoire /var/www et téléchargez le code source de Matomo en utilisant la commande wget ci-dessous.

cd /var/www/  
wget https://builds.matomo.org/matomo.zip

Une fois téléchargé, exécutez la commande unzip ci-dessous pour extraire le fichier matomo.zip. Et ensuite, changez la propriété du répertoire /var/www/matomo à l’utilisateur www-data.

unzip matomo.zip  
sudo chown -R www-data:www-data /var/www/matomo

Configuration de l’hôte virtuel Apache

Après avoir téléchargé Matomo, vous créerez un nouveau fichier d’hôte virtuel Apache pour Matomo. Assurez-vous donc que votre nom de domaine est pointé vers une adresse IP de serveur.

Créez un nouveau fichier d’hôte virtuel Apache /etc/apache2/sites-available/matomo.conf avec l’éditeur nano.

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

Insérez la configuration ci-dessous et assurez-vous de remplacer l’option ServerName par votre nom de domaine.


    ServerAdmin webmaster@localhost
    ServerName matomo.howtoforge.local
    DocumentRoot /var/www/matomo/

    
        DirectoryIndex index.php
        Options FollowSymLinks
        AllowOverride All
        Require all granted
    

    
        Options None
        Require all denied
    

    
        Options None
        Require all granted
    

    
        Options None
        Require all denied
    

    
        Options None
        Require all denied
    

    ErrorLog ${APACHE_LOG_DIR}/matomo_error.log
    CustomLog ${APACHE_LOG_DIR}/matomo_access.log combined

Enregistrez le fichier et quittez lorsque vous avez terminé.

Maintenant, exécutez la commande a2ensite ci-dessous pour activer le fichier matomo.conf. Ensuite, exécutez la commande apachectl ci-dessous pour vérifier votre configuration Apache. Si vous avez une syntaxe Apache correcte, vous verrez une sortie Syntax is OK.

sudo a2ensite matomo.conf  
sudo apachectl configtest

Enfin, exécutez la commande systemctl ci-dessous pour redémarrer le serveur web Apache et appliquer vos modifications. Une fois Apache redémarré, votre installation de Matomo est prête.

sudo systemctl restart apache2

setup apache

Sécuriser Matomo avec HTTPS

Dans cette section, vous générerez des certificats SSL/TLS et sécuriserez Matomo avec HTTPS via Certbot et Letsencrypt.

Installez les paquets certbot et python3-certbot-apache avec la commande ci-dessous.

sudo apt install certbot python3-certbot-apache

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

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

Après le processus, vos certificats SSL seront disponibles dans le répertoire /etc/letsencrypt/live/donmain.com. De plus, votre installation de Matomo est sécurisée avec HTTPS.

Installation de Matomo Web Analytics

Ouvrez votre navigateur web et visitez votre nom de domaine Matomo tel que https://matomo.howtoforge.local/. Si l’installation est réussie, vous verrez le message de bienvenue comme suit :

Cliquez sur Suivant pour confirmer l’installation.

welcome message

Dans la section Vérification du système, assurez-vous que votre système est prêt et cliquez à nouveau sur Suivant.

system check

Maintenant, saisissez les détails, y compris le nom de la base de données MariaDB, l’utilisateur et le mot de passe, puis cliquez sur Suivant pour migrer la base de données.

setup database

Une fois la migration terminée, cliquez à nouveau sur Suivant.

database migration

Entrez un nouveau nom d’utilisateur administrateur, une adresse e-mail et un mot de passe pour Matomo Web Analytics.

setup admin

Maintenant, entrez les informations pour créer le premier suivi avec Matomo et cliquez sur Suivant.

create first tracking

Copiez le code de suivi généré et cliquez sur Suivant.

tracking code

Après l’installation, vous verrez les messages suivants :

install complete

Si vous visitez la page d’accueil de Matomo, vous serez redirigé vers la page de connexion de Matomo. Entrez votre utilisateur admin et votre mot de passe, puis cliquez sur SE CONNECTER.

logging in

Après vous être connecté, vous verrez le tableau de bord d’administration de Matomo suivant :

dashboard

Conclusion

Félicitations ! Vous avez terminé l’installation de Matomo Web Analytics sur le serveur Debian 12. Matomo Web Analytics est opérationnel avec le serveur web Apache, le serveur de base de données MariaDB et PHP 8.3. Vous avez également sécurisé Matomo avec HTTPS via Certbot et Letsencrypt.