Installation Matomo · 12 min read · Dec 21, 2025

Comment installer Matomo Web Analytics sur Ubuntu 22.04

Matomo, anciennement Piwik, est un logiciel d’analyse web gratuit et open-source qui peut suivre les visites de sites web et afficher des rapports pour l’analyse des données et du public. Matomo est sous licence GPL. Il est écrit en PHP et peut être exécuté 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 comme les téléchargements de fichiers, et bien plus encore. Matomo devient de plus en plus populaire comme alternative aux services d’analyse tels que Google Analytics.

Dans ce tutoriel, vous allez configurer et sécuriser votre analyse web avec Matomo sur un serveur Ubuntu 22.04. Vous installerez Matomo Web Analytics avec PHP 8.1, le serveur web Apache2, et la base de données MariaDB, et sécuriserez le déploiement avec des certificats SSL/TLS via Certbot et Letsencrypt. Une fois ce tutoriel terminé, vous serez en mesure de suivre et de surveiller le trafic sur vos sites web, et vous obtiendrez des résultats de suivi détaillés sur votre installation Matomo auto-hébergée.

Prérequis

Voici les exigences que vous devez avoir pour compléter ce tutoriel :

  • Un serveur Ubuntu 22.04 - Cet exemple utilise un serveur Ubuntu avec le nom d’hôte ‘ matomo-server ‘.
  • Un utilisateur non-root avec des privilèges d’administrateur sudo/root.
  • Un nom de domaine pointé vers l’adresse IP du serveur - Cet exemple utilisera le sous-domaine ‘ analytics.howtoforge.local ‘.

Une fois toutes les exigences en place, vous pouvez maintenant commencer.

Installation et configuration du serveur MariaDB

Matomo est une analyse web open-source qui utilise MySQL ou MariaDB comme backend de base de données. Au moment de la rédaction de ce document, Matomo nécessitait au moins le serveur MySQL v8 ou MariaDB v10.x. Dans ce guide, vous installerez et utiliserez MariaDB comme base de données pour Matomo Web Analytics.

Dans la première étape, vous installerez le serveur MariaDB, configurerez le déploiement de MariaDB, et créerez une nouvelle base de données et un nouvel utilisateur MariaDB.

Avant de commencer, exécutez la commande apt ci-dessous pour mettre à jour et rafraîchir votre index de paquets.

sudo apt update

Maintenant, installez le serveur MariaDB via la commande apt ci-dessous. Lorsque vous y êtes invité, saisissez y et appuyez sur ENTRER pour continuer.

sudo apt install mariadb-server

installer mariadb

Après l’installation du serveur MariaDB, exécutez l’utilitaire de commande systemctl ci-dessous pour vérifier et vous assurer que le serveur MariaDB fonctionne.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Vous devriez recevoir une sortie similaire à celle-ci - Le serveur MariaDB est activé et fonctionne par défaut. De plus, le serveur MariaDB démarrera automatiquement au démarrage.

vérifier mariadb

Ensuite, vous sécuriserez le déploiement du serveur MariaDB via la commande ‘ mariadb-secure-installation ‘, qui est fournie par le paquet du serveur MariaDB.

Exécutez la commande ci-dessous pour sécuriser le déploiement du serveur MariaDB.

sudo mariadb-secure-installation

On vous demandera maintenant les configurations suivantes de MariaDB :

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

Maintenant, le déploiement du serveur MariaDB devrait être sécurisé et vous avez ajouté le mot de passe pour l’utilisateur root de MariaDB.

Ensuite, vous créerez une nouvelle base de données et un nouvel utilisateur MariaDB pour l’installation de Matomo via le shell MariaDB.

Exécutez la commande ‘mariadb’ ci-dessous pour vous connecter au shell MariaDB via l’utilisateur root de MariaDB. Lorsque vous êtes invité à entrer le mot de passe, saisissez votre mot de passe root de MariaDB.

sudo mariadb -u root -p

Maintenant, exécutez les requêtes suivantes pour créer une nouvelle base de données et un nouvel utilisateur MariaDB. Dans cet exemple, vous allez créer la base de données et l’utilisateur ‘ matomo ‘ pour l’installation de Matomo. Assurez-vous également de remplacer le mot de passe par défaut dans la requête suivante.

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

créer base de données et utilisateur

Ensuite, exécutez la requête ci-dessous pour vérifier la liste des privilèges de l’utilisateur ‘ matomo@localhost ‘.

SHOW GRANTS FOR 'matomo'@'localhost';  
quit

Vous devriez obtenir une sortie similaire à celle-ci - L’utilisateur MariaDB ‘matomo@localhost’ a tous les privilèges pour accéder à la base de données ‘matomo’.

montrer privilèges

Dans cette section, vous avez installé le serveur MariaDB, sécurisé le déploiement de MariaDB via la commande ‘ mariadb-secure-installation ‘, et créé une nouvelle base de données et un nouvel utilisateur pour Matomo. Ensuite, vous allez installer le serveur web Apache2 et PHP 8.x.

Installation du serveur web Apache2 et de PHP 8

Matomo est une analyse web open-source écrite en PHP. Pour l’installation, la dernière version de Matomo est entièrement prise en charge avec PHP 8.x. De plus, Matomo peut être exécuté avec les serveurs web Apache2 et Nginx.

Dans cette étape, vous allez maintenant installer le serveur web Apache2 et PHP 8.1, configurer l’installation de PHP, puis vérifier le service Apache2 et la version de PHP.

Le dépôt par défaut d’Ubuntu fournit à la fois les paquets Apache2 et PHP. Le dépôt Ubuntu 22.04 fournit la dernière version de PHP, PHP8.1, qui est entièrement prise en charge pour l’installation de Matomo.

Exécutez la commande apt ci-dessous pour installer les paquets Apache2 et PHP 8.1.

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

Lorsque vous y êtes invité, saisissez y pour confirmer et appuyez sur ENTRER pour continuer.

installer apache2 php 8

Après l’installation d’Apache2 et de PHP, exécutez l’utilitaire de commande systemctl ci-dessous pour vérifier le service Apache2 et vous assurer que le service fonctionne.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Vous recevrez une sortie comme celle-ci - Le service Apache2 est activé et sera exécuté automatiquement au démarrage. Et le statut du service Apache2 est en cours d’exécution.

vérifier le service apache2

Ensuite, ouvrez le fichier ‘ php.ini ‘ pour Apache2 via la commande de l’éditeur nano ci-dessous.

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

Changez la configuration par défaut de php.ini avec les lignes suivantes. Ajustez la valeur date.timezone et memory_limit avec votre environnement actuel.

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

Enregistrez et quittez le fichier lorsque vous avez terminé.

Maintenant, exécutez l’utilitaire de commande systemctl ci-dessous pour redémarrer le service Apache2 et appliquer les modifications.

sudo systemctl restart apache2

Le serveur web Apache2 devrait maintenant fonctionner avec le nouveau fichier de configuration php.ini.

Enfin, exécutez la commande php ci-dessous pour vérifier la version de PHP qui est installée sur votre système. Ensuite, vérifiez la liste des extensions PHP qui sont activées.

sudo php --version  
sudo php -m

Vous devriez recevoir une sortie similaire à celle-ci - PHP 8.1 est installé sur votre système Ubuntu. Assurez-vous également que les extensions PHP requises pour Matomo sont activées.

vérifier la version php

Maintenant, vous avez terminé d’installer les dépendances pour Matomo Web Analytics, y compris le serveur MariaDB, le serveur web Apache2, et PHP 8.1.

Dans l’étape suivante, vous allez télécharger le code source de Matomo et configurer les permissions appropriées pour le répertoire d’installation de Matomo afin que PHP et Apache2 puissent lire et exécuter l’application Matomo.

Téléchargement du code source de Matomo

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

Changez votre répertoire de travail actuel en ‘/var/www/ ‘ et téléchargez le code source de Matomo via la commande wget.

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

Après le téléchargement du code source de Matomo, extrayez le code source de Matomo via la commande unzip ci-dessous. Et vous devriez obtenir le nouveau répertoire ‘ matomo ‘ dans votre répertoire de travail actuel.

unzip matomo.zip

Avec cela, votre répertoire d’installation de Matomo devrait être ‘/var/www/matomo ‘.

Exécutez la commande ci-dessous pour changer la propriété du répertoire d’installation de Matomo ‘ /var/www/matomo ‘ à l’utilisateur et au groupe ‘ www-data ‘.

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

Après avoir configuré le répertoire d’installation de Matomo et téléchargé le code source de Matomo. Ensuite, vous allez créer une nouvelle configuration d’hôte virtuel qui sera utilisée pour exécuter Matomo Web Analytics.

Configuration de l’hôte virtuel Matomo

Avant de commencer, assurez-vous que vous avez le nom de domaine pointé vers votre adresse IP de serveur. Cet exemple utilise le sous-domaine ‘ analytics.howtoforge.local ‘ pour l’installation de Matomo.

Créez un nouveau fichier d’hôte virtuel Apache2 ‘/etc/apache2/sites-available/matomo.conf ‘ en utilisant la commande de l’éditeur nano ci-dessous.

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

Ajoutez les lignes suivantes au fichier et assurez-vous de changer le nom de domaine avec votre domaine.

  
    ServerAdmin webmaster@localhost  
    ServerName analytics.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 l’éditeur lorsque vous avez terminé.

Ensuite, exécutez la commande ci-dessous pour activer la nouvelle configuration d’hôte virtuel ‘ matomo.conf ‘. Puis vérifiez les configurations d’Apache2 pour vous assurer que vous avez la configuration correcte sans erreur.

sudo a2ensite matomo.conf  
sudo apachectl configtest

Vous devriez recevoir une sortie telle que ‘ Syntaxe OK ‘ lorsque vous avez des configurations Apache2 correctes.

configurer l'hôte virtuel matomo

Enfin, exécutez l’utilitaire de commande systemctl ci-dessous pour redémarrer le service Apache2 et appliquer les modifications.

sudo systemctl restart apache2

Avec cela, vous avez maintenant terminé la configuration de l’hôte virtuel Apache2 pour Matomo Web Analytics. Cela signifie que votre Matomo est maintenant accessible depuis l’extérieur du réseau et vous pouvez y accéder via le navigateur web. Mais, cela utilise toujours des connexions HTTP non sécurisées.

Dans l’étape suivante, vous allez sécuriser votre installation Matomo Web Analytics avec des certificats SSL/TLS via Certbot et Letsencrypt.

Sécurisation de Matomo avec SSL/TLS via Certbot et Letsencrypt

Dans cette étape, vous allez installer l’outil Certbot et le plugin pour le serveur web Apache2. Ensuite, vous allez générer de nouveaux certificats SSL/TLS pour Matomo Web Analytics.

Avant de commencer, assurez-vous que votre nom de domaine est pointé vers votre adresse IP de serveur. De plus, vous avez besoin d’une adresse e-mail qui sera utilisée pour s’inscrire à Letsencrypt.

Maintenant, exécutez la commande apt ci-dessous pour installer l’outil Certbot et le plugin Certbot pour le serveur web Apache2.

sudo apt install certbot python3-certbot-apache2

Saisissez y lorsque vous y êtes invité et appuyez sur ENTRER pour continuer.

installer certbot

Ensuite, exécutez la commande certbot ci-dessous pour générer des certificats SSL/TLS pour votre nom de domaine. Assurez-vous de changer le nom de domaine et l’adresse e-mail dans la commande suivante.

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

Après la fin du processus, votre Matomo Web Analytics devrait maintenant fonctionner avec HTTPS sécurisé activé sur votre serveur web Apache. De plus, vous avez configuré la redirection automatique de HTTP vers HTTPS et l’OSCP staple activé.

Installation de Matomo Web Analytics

Ouvrez votre navigateur web et visitez le nom de domaine de votre installation Matomo (c’est-à-dire : https://analytics.howtoforge.local). Vous devriez maintenant obtenir la page d’accueil de Matomo comme ci-dessous.

Cliquez sur Suivant pour commencer l’installation.

bienvenue à matomo

Maintenant, l’installateur de Matomo va vérifier les environnements du serveur pour l’installation. Assurez-vous que toutes les exigences et configurations sont vérifiées avec une couleur verte comme ci-dessous.

vérifications système Matomo

De plus, vous devez vous assurer que les exigences principales sont satisfaites avec les exigences système de Matomo.

configurer la base de données

Cliquez sur Suivant pour continuer.

Vous allez maintenant configurer les détails de la base de données MariaDB pour votre Matomo Web Analytics. Assurez-vous de saisir le bon nom d’utilisateur et mot de passe de la base de données. Ensuite, cliquez sur Suivant à nouveau.

configuration de la base de données

L’installateur web de Matomo devrait automatiquement créer des tables lorsque vos détails de base de données sont corrects.

Cliquez sur Suivant pour continuer.

tables créées

Ensuite, vous devrez créer un nouvel utilisateur administrateur pour votre installation Matomo Web Analytics. Assurez-vous d’utiliser un mot de passe fort pour votre utilisateur administrateur Matomo. Ensuite, cliquez sur Suivant à nouveau.

créer admin

Dans ce cas, vous allez configurer le premier suivi pour votre site web. Dans le nom de domaine de votre site web que vous souhaitez suivre, sélectionnez le fuseau horaire, puis cliquez sur Suivant.

configurer le premier suivi

Maintenant, vous devriez voir le code JavaScript que vous devez saisir dans vos sites web. Cliquez sur Suivant à nouveau pour continuer.

code de suivi JavaScript

Vous devriez maintenant obtenir le message de félicitations que vous avez terminé l’installation de Matomo. Cliquez sur le bouton CONTINUER VERS MATOMO en bas de la page.

installation terminée

Vous serez maintenant redirigé vers une connexion HTTPS sécurisée pour la page de connexion à l’administration de Matomo. Saisissez votre nom d’utilisateur et votre mot de passe Matomo, puis cliquez sur CONNEXION.

page de connexion Matomo

Si vous avez le bon utilisateur administrateur et le bon mot de passe, vous devriez obtenir l’administration web de Matomo Web Analytics.

tableau de bord matomo

Maintenant, cliquez sur le menu Tous les sites en haut à droite pour obtenir la liste des sites de votre suivi actif. Vous devriez voir le premier suivi de site que vous avez créé lors de l’installation de Matomo.

liste des sites Matomo

Vous avez maintenant terminé l’installation de Matomo Web Analytics. Vous pouvez ajouter plus de sites web et commencer à suivre via Matomo Web Analytics auto-hébergé.

Conclusion

Dans cet article, vous avez installé l’analyse web open-source Matomo avec le serveur de base de données MariaDB, le serveur web Apache2, et PHP 8.1 sur un serveur Ubuntu 22.04. Vous avez également sécurisé Matomo avec des certificats SSL/TLS générés via Certbot et Letsencrypt.

Maintenant que vous avez installé les bases de Matomo Web Analytics, vous pouvez maintenant intégrer Matomo avec des CMS (systèmes de gestion de contenu) tels que WordPress, TYPO3, Joomla, Drupal, etc. De plus, vous pouvez intégrer avec des applications eCommerce telles que Magento, Prestashop, Woocommerce, et OpenCart.

Share: X/Twitter LinkedIn

Recevez de nouveaux articles dans votre boîte de réception.

Aucun spam. Désabonnez-vous à tout moment.