Installation Matomo · 7 min read · Dec 23, 2025

Comment installer Matomo Web Analytics sur Ubuntu 18.04 LTS

Matomo (anciennement Piwik) est une application d’analyse web gratuite et open source développée par une équipe de développeurs internationaux, qui fonctionne sur un serveur web PHP / MySQL. Elle suit les visites en ligne sur un ou plusieurs sites web et affiche des rapports sur ces visites pour analyse. Vous pouvez le considérer comme une alternative à Google Analytics. Matomo est open source et son code est disponible publiquement sur Github. Certaines de ses fonctionnalités incluent : A/B Testing, Heatmaps, Funnels, API de suivi et de reporting, Google AdWords, Facebook Ads, Bing Ads, Coût par clic (CPC), etc. Ce tutoriel vous montrera comment installer Matomo sur un système Ubuntu 18.04 LTS en utilisant Nginx comme serveur web et nous sécuriserons le site avec un certificat SSL Let’s Encrypt.

Exigences

Pour exécuter Matomo (Piwik) sur votre système Ubuntu, vous aurez besoin de quelques éléments :

  • Serveur web tel qu’Apache, Nginx, IIS.
  • Version PHP 5.5.9 ou supérieure avec les extensions pdo et pdo_mysql ou mysqli, gd, xml, curl et mbstring. PHP 7+ est recommandé.
  • Version MySQL 5.5 ou supérieure, ou la version équivalente de MariaDB. MySQL 5.7+ est recommandé.

Prérequis

  • Un système d’exploitation exécutant Ubuntu 18.04.
  • Un utilisateur non-root avec des privilèges sudo.

Étapes initiales

Vérifiez votre version d’Ubuntu :

lsb_release -ds  
# Ubuntu 18.04.1 LTS

Configurez le fuseau horaire :

sudo dpkg-reconfigure tzdata

Mettez à jour les paquets de votre système d’exploitation (logiciel). C’est une première étape importante car elle garantit que vous disposez des dernières mises à jour et correctifs de sécurité pour les paquets logiciels par défaut de votre système d’exploitation :

sudo apt update && sudo apt upgrade -y

Installez quelques paquets essentiels nécessaires à l’administration de base du système d’exploitation Ubuntu :

sudo apt install -y curl wget vim git unzip socat

Étape 1 - Installer MySQL et créer une base de données pour Matomo

Matomo prend en charge les bases de données MySQL et MariaDB. Dans ce tutoriel, nous utiliserons MySQL comme serveur de base de données.

Installez le serveur de base de données MySQL :

sudo apt install -y mysql-server

Vérifiez la version de MySQL :

mysql --version  
# mysql  Ver 14.14 Distrib 5.7.24, for Linux (x86_64) using  EditLine wrapper

Exécutez le script mysql_secure_installation pour améliorer la sécurité de MySQL et définir le mot de passe pour l’utilisateur root de MySQL :

sudo mysql_secure_installation

Répondez à chacune des questions :

`Souhaitez-vous configurer le plugin VALIDATE PASSWORD ? N  
Nouveau mot de passe : your_secure_password  
Ressaisissez le nouveau mot de passe : your_secure_password  
Supprimer les utilisateurs anonymes ? [Y/n] Y  
Interdire la connexion root à distance ? [Y/n] Y  
Supprimer la base de données de test et l'accès à celle-ci ? [Y/n] Y  
Recharger les tables de privilèges maintenant ? [Y/n] Y`

Connectez-vous à l’interface de commande MySQL en tant qu’utilisateur root :

sudo mysql -u root -p  
# Entrez le mot de passe

Créez une base de données MySQL vide et un utilisateur pour Matomo et retenez les identifiants :

mysql> CREATE DATABASE dbname;  
mysql> GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';  
mysql> FLUSH PRIVILEGES;

Quittez MySQL :

mysql> exit

Remplacez dbname, username et password par vos propres noms.

Étape 2 - Installer PHP et les extensions PHP nécessaires

Installez PHP, ainsi que les extensions PHP nécessaires :

sudo apt install -y php7.2 php7.2-cli php7.2-fpm php7.2-common php7.2-curl php7.2-gd php7.2-xml php7.2-mbstring php7.2-mysql

Vérifiez la version de PHP :

php --version  
  
# PHP 7.2.10-0ubuntu0.18.04.1 (cli) (construit : Sep 13 2018 13:45:02) ( NTS )  
# Copyright (c) 1997-2018 The PHP Group  
# Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies  
#     avec Zend OPcache v7.2.10-0ubuntu0.18.04.1, Copyright (c) 1999-2018, par Zend Technologies

Le service PHP-FPM est automatiquement démarré et activé au démarrage sur le système Ubuntu 18.04, donc il n’est pas nécessaire de le démarrer et de l’activer manuellement. Nous pouvons passer à l’étape suivante, qui consiste à obtenir des certificats SSL gratuits de Let’s Encrypt CA.

Étape 3 - Installer le client acme.sh et obtenir le certificat Let’s Encrypt (optionnel)

Sécuriser votre site web avec HTTPS n’est pas nécessaire, mais c’est une bonne pratique pour sécuriser le trafic de votre site. Afin d’obtenir un certificat TLS de Let’s Encrypt, nous utiliserons le client Acme.sh. Acme.sh est un logiciel shell pur unix pour obtenir des certificats TLS de Let’s Encrypt sans dépendances.

Téléchargez et installez Acme.sh :

sudo mkdir /etc/letsencrypt  
git clone https://github.com/Neilpang/acme.sh.git  
cd acme.sh  
sudo ./acme.sh --install --home /etc/letsencrypt --accountemail [email protected]  
cd ~

Vérifiez la version d’Acme.sh :

/etc/letsencrypt/acme.sh --version  
# v2.8.0

Obtenez des certificats RSA et ECC/ECDSA pour votre domaine/nom d’hôte : 

# RSA 2048  
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d example.com --keylength 2048  
# ECDSA  
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d example.com --keylength ec-256

Après avoir exécuté les commandes ci-dessus, vos certificats et clés seront dans :

  • Pour RSA : le répertoire /etc/letsencrypt/example.com.
  • Pour ECC/ECDSA : le répertoire /etc/letsencrypt/example.com_ecc.

Étape 3 - Installer NGINX et configurer NGINX pour Matomo

Matomo peut bien fonctionner avec de nombreux logiciels de serveur web populaires. Dans ce tutoriel, nous avons sélectionné Nginx.

Téléchargez et installez la dernière version principale de Nginx depuis le dépôt Ubuntu :

sudo apt install -y nginx

Vérifiez la version de Nginx :

sudo nginx -v  
# version nginx : nginx/1.14.0

Configurez Nginx pour Matomo en exécutant :

sudo vim /etc/nginx/sites-available/matomo.conf

Et remplissez le fichier avec la configuration suivante :

server {  
  
  listen [::]:443 ssl http2;  
  listen 443 ssl http2;  
  listen [::]:80;  
  listen 80;  
  
  server_name example.com;  
  root /var/www/matomo/;  
  index index.php;  
  
  ssl_certificate /etc/letsencrypt/example.com/fullchain.cer;   
  ssl_certificate_key /etc/letsencrypt/example.com/example.com.key;   
  ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.cer;  
  ssl_certificate_key /etc/letsencrypt/example.com_ecc/example.com.key;  
  
  location ~ ^/(index|matomo|piwik|js/index).php {  
    include snippets/fastcgi-php.conf;  
    fastcgi_param HTTP_PROXY "";   
    fastcgi_pass unix:/var/run/php/php7.2-fpm.sock;   
  }    
  
  location = /plugins/HeatmapSessionRecording/configs.php {  
    include snippets/fastcgi-php.conf;  
    fastcgi_param HTTP_PROXY "";  
    fastcgi_pass unix:/var/run/php/php7.2-fpm.sock;  
  }  
  
  location ~* ^.+\.php$ {  
    deny all;  
    return 403;  
  }  
  
  location / {  
    try_files $uri $uri/ =404;  
  }    
  
  location ~ /(config|tmp|core|lang) {  
    deny all;  
    return 403;  
  }  
  
  location ~ \.(gif|ico|jpg|png|svg|js|css|htm|html|mp3|mp4|wav|ogg|avi|ttf|eot|woff|woff2|json)$ {  
    allow all;  
  }  
  
  location ~ /(libs|vendor|plugins|misc/user) {  
    deny all;  
    return 403;  
  }  
  
}

REMARQUE : Pour une configuration Nginx complète et prête pour la production pour Matomo, visitez https://github.com/matomo-org/matomo-nginx.

Activez la nouvelle configuration matomo.conf en liant le fichier au répertoire sites-enabled.

sudo ln -s /etc/nginx/sites-available/matomo.conf /etc/nginx/sites-enabled

Vérifiez la configuration de Nginx pour les erreurs de syntaxe :

sudo nginx -t

Rechargez le service Nginx :

sudo systemctl reload nginx.service

Étape 4 - Installer Matomo Analytics

Créez le répertoire /var/www :

sudo mkdir -p /var/www/

Naviguez vers le répertoire /var/www :

cd /var/www/

Téléchargez la dernière version de Matomo via wget et décompressez-la :

sudo wget https://builds.matomo.org/matomo.zip && sudo unzip matomo.zip

Supprimez le fichier matomo.zip téléchargé :

sudo rm matomo.zip

Changez la propriété du répertoire /var/www/matomo à l’utilisateur www-data :

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

Étape 5 - Compléter la configuration de Matomo Analytics

Ouvrez votre site dans un navigateur web et suivez l’assistant d’installation web de Matomo.

Tout d’abord, le message de bienvenue de Matomo devrait apparaître. Cliquez sur le bouton “Suivant” : Assistant d'installation Matomo

Ensuite, vous verrez une page “Vérification du système”. Si quelque chose manque, vous verrez un avertissement. Si tout est marqué avec une coche verte, cliquez sur le bouton “Suivant” pour passer à l’étape suivante : Vérification du système

Ensuite, remplissez les détails de la base de données et cliquez sur le bouton “Suivant” : Configuration de la base de données

Si tout s’est bien passé avec la configuration de la base de données, vous devriez voir le message “Tables créées avec succès !” : Création des tables de base de données

Créez un compte super utilisateur Matomo et cliquez sur le bouton “Suivant” : Créer un compte super utilisateur

Ensuite, configurez le premier site web que vous souhaitez suivre et analyser avec Matomo. Plus tard, vous pourrez ajouter d’autres sites à suivre avec Matomo : Ajouter un site web à Matomo

Ensuite, vous recevrez le code de suivi JavaScript pour votre site que vous devez ajouter pour commencer à suivre. Code de suivi Javascript

Ensuite, vous devriez voir que l’installation de Matomo est terminée. Installation de Matomo terminée

Félicitations ! Votre installation de Matomo est complète.

Liens

Share: X/Twitter LinkedIn
#Installation Matomo

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

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