Comment installer Plausible Analytics avec Docker sur Ubuntu 22.04

Plausible est une alternative d'analyse Web open source à Google Analytics. Il s'agit d'une analyse Web légère et axée sur la confidentialité qui peut être utilisée pour plusieurs secteurs tels que les startups, les indépendants et les blogueurs.

Analyse Web plausible, légère et simple. Il fournit des métriques importantes sur une seule page, ce qui facilite l’analyse des métriques par le webmaster. Plausible est disponible en deux versions, le service Plausible que vous devez payer à l'utilisateur et le service Plausible auto-hébergé que vous pouvez installer sur votre serveur.

Plausible Analytics vous permet de créer des analyses de sites Web auto-hébergées sur votre serveur et vous permet de suivre les sites Web de manière illimitée. Dans ce guide, vous apprendrez comment installer et configurer Plausible Analytics via Docker sur un serveur Ubuntu 22.04. Vous configurerez également Nginx comme proxy inverse pour l'application Plausible Analytics et configurerez SSL via Letsencrypt.

Conditions préalables

Pour commencer, vous aurez besoin des conditions suivantes pour compléter ce guide :

• Un serveur Ubuntu 22.04 : cet exemple utilise un serveur avec le nom d'hôte « plausible-server ».
• Un utilisateur non root avec les privilèges d'administrateur sudo/root.
• Un nom de domaine ou un sous-domaine pointant vers l'adresse IP du serveur - Cet exemple utilise le sous-domaine 'plausible.hwdomain.io'.

Installation de Docker CE (édition communautaire)

Plausible Analytics peut être déployé et auto-hébergé via Docker sur n'importe quel système d'exploitation prenant en charge le moteur Docker. Pour ce faire, vous devez d'abord installer Docker Engine sur la machine cible sur laquelle vous souhaitez déployer l'application Plausible.

Commencez par ce guide en installant Docker CE (Community Edition) sur votre serveur Ubuntu via le référentiel Docker officiel.

Exécutez la commande apt ci-dessous pour installer certaines dépendances de base. Lorsque vous êtes invité à effectuer la configuration, saisissez y et appuyez sur ENTRÉE pour continuer.

sudo apt install \
    ca-certificates \
    curl \
    gnupg \
    lsb-release

Ensuite, exécutez la commande suivante pour télécharger la clé GPG pour le référentiel Docker. Ensuite, ajoutez le référentiel Docker officiel à votre système.

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Une fois la clé GPG et le référentiel Docker ajoutés, actualisez et mettez à jour votre référentiel via la commande apt ci-dessous.

sudo apt update

Vous recevrez le résultat comme celui-ci : le référentiel Docker CE est ajouté.

Installez maintenant Docker CE et Docker Compose à l'aide de la commande apt suivante.

sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin

Saisissez y pour confirmer l'installation, puis appuyez sur ENTRÉE pour continuer.

Une fois Docker installé, exécutez la commande systemctl suivante pour vérifier l'état actuel du service Docker.

sudo systemctl is-enabled docker
sudo systemctl status docker

Vous devriez maintenant recevoir le résultat du service Docker en cours d'exécution et activé. Le Docker sera désormais automatiquement exécuté au démarrage du système.

Maintenant que Docker est installé, la prochaine étape consistera à configurer l'installation de Plausible Analytics.

Téléchargement et configuration d'analyses plausibles

Une fois Docker installé, vous allez maintenant télécharger le code source de Plausible Analytics et configurer la variable d'environnement qui sera utilisée lors du déploiement. Cela inclut certains paramètres importants tels que l'utilisateur et le mot de passe administrateur, le nom de domaine Plausible pour l'installation et le SECRET_KEY_BASE qui sera utilisé pour sécuriser Plausible.

Déplacez le répertoire de travail vers '/opt'. Ensuite, téléchargez le code source Plausible via la commande git ci-dessous.

cd /opt
sudo git clone https://github.com/plausible/hosting plausible

Ensuite, exécutez la commande suivante pour générer le SECRET_KEY_BASE pour Plausible Analytics.

openssl rand 64 | base64 -w 0 ; echo

Vous recevrez la chaîne aléatoire générée - assurez-vous de la sauvegarder, vous utiliserez ici la chaîne aléatoire générée comme SECRET_KEY_BASE pour Plausible.

Déplacez maintenant le répertoire de travail vers '/opt/plausible', qui est le répertoire d'installation de Plasibble. Ensuite, utilisez la commande suivante de l'éditeur nano pour modifier le fichier de configuration « plausible-conf.env ».

cd /opt/plausible
sudo nano plausible-conf.env

Modifiez la configuration des détails avec votre environnement de déploiement. Assurez-vous également de modifier les détails de l'utilisateur administrateur, de l'adresse e-mail et du mot de passe. Et aussi le nom de domaine de votre installation et le SECRET_KEY_BASE avec la chaîne aléatoire que vous avez générée.

Les configurations suivantes seront utilisées comme variable lors du déploiement de Plausible Analytic via Docker et Docker Compose.

[email 
ADMIN_USER_NAME=alice
ADMIN_USER_PWD=admin_alice_password
BASE_URL=https://plausible.hwdomain.io
SECRET_KEY_BASE=WI+Dzf5ZsvbL+tapfDuIyOr2rhQqcss10XnQkX3b/BjOucweWvHjqpFtb9kV69O1PwvbOxaBvotlGbh6vry//Q==

Enregistrez le fichier et quittez l'éditeur lorsque vous avez terminé.

Exécuter des analyses plausibles avec Docker Compose

Maintenant que vous avez configuré l'environnement qui sera utilisé pour le déploiement plausible. Vous allez maintenant configurer le script docker-compose.yml et déployer Plausible via Docker Compose.

Déplacez votre répertoire de travail vers le répertoire d'installation Plausible '/opt/plausible'.

cd /opt/plausible

Utilisez l'éditeur nano suivant pour modifier le fichier de configuration Docker Compose « docker-compose.yml ».

sudo nano docker-compose.yml

Dans la section de service « plausible », modifiez la configuration par défaut des « ports » avec la configuration suivante. Avec ce paramètre, le service Plausible Analytic sera exécuté sur l'hôte local sur le port par défaut 8000.

plausible:
......
    ports:
      - 127.0.0.1:8000:8000
......

Enregistrez le fichier et quittez l'éditeur lorsque vous avez terminé.

Une fois que vous avez modifié le fichier docker-compose.yml, exécutez la commande docker ci-dessous pour commencer à créer et à déployer le service Plausible Analytic.

sudo docker compose up -d

Une fois la commande exécutée, Docker téléchargera les images qui seront utilisées pour le déploiement Plausible, qui inclut PostgreSQL comme base de données. Et aussi, vous verrez de nouveaux volumes être créés.

Vous trouverez ci-dessous le résultat des processus de déploiement plausibles.

Une fois le déploiement plausible terminé, vous devriez voir ci-dessous que les services de conteneur sont démarrés.

Vérifiez maintenant le conteneur et les services en cours d'exécution via la commande docker ci-dessous. Et vous devriez voir que les services plausibles sont en cours d'exécution.

sudo docker compose ps

Vous pouvez également vérifier la liste des images Docker disponibles sur votre système via la commande ci-dessous. Et vous devriez voir plusieurs images, y compris les images PostgreSQL et Plausible.

sudo docker compose images

Enfin, exécutez la commande suivante pour vérifier que le service Plausible est en cours d'exécution. Cela tentera d'atteindre le service Plausible exécuté sur localhost avec le port par défaut 8000.

curl http://localhost:8000

Dans le résultat suivant, vous pouvez voir que vous êtes redirigé vers le chemin URL « /login » pour la page de connexion plausible.

Configuration d'Apache2 en tant que proxy inverse

Maintenant que Plausible Analytics est exécuté dans Docker. Vous allez maintenant installer le serveur Web Apache2 et le configurer comme proxy inverse pour l'application Web Plausible.

Exécutez la commande apt suivante pour installer le serveur Web Apache2 sur votre système. Saisissez y pour confirmer l’installation et appuyez sur ENTRÉE pour continuer.

sudo apt install apache2

Vérifiez maintenant le service Apache2 pour vous assurer qu'il est en cours d'exécution. Utilisez la commande systemctl suivante.

sudo systemctl is-enabled apache2
sudo systemctl status apache2

Dans le résultat suivant, vous verrez que le service Apache2 est en cours d'exécution et activé. Cela signifie que le service Apache2 sera exécuté automatiquement au démarrage du système.

Maintenant que le serveur Web Apache2 est installé, vous allez ensuite configurer l'hôte virtuel qui sera utilisé comme proxy inverse pour l'application Web Plausible Analytics.

Pour commencer, exécutez la commande suivante pour activer certains modules Apache2. Cela inclut les modules qui exécuteront Apache2 en tant que proxy inverse et le module mod_ssl.

sudo a2enmod proxy proxy_http proxy_ajp remoteip headers ssl

Vous devriez voir le résultat comme celui-ci.

Ensuite, exécutez la commande suivante pour copier la configuration de l'hôte virtuel par défaut pour le proxy inverse Apache2 dans le répertoire '/etc/apache2/sites-available/'.

sudo cp /opt/plausible/reverse-proxy/apache2/plausible.conf /etc/apache2/sites-available/

Utilisez maintenant la commande suivante de l'éditeur nano pour modifier la configuration de l'hôte virtuel '/etc/apache2/sites-available/plausible.conf'.

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

Changez le nom de domaine de l'installation Plausible avec votre domaine. Dans cet exemple, Plausible Analytics sera exécuté sur le sous-domaine « plausible.hwdomain.io ».

ServerAdmin [email 
ServerName plausible.hwdomain.io

Enregistrez le fichier et quittez l'éditeur lorsque vous avez terminé.

Ensuite, activez la configuration de l'hôte virtuel 'plausible.conf' via la commande a2ensite ci-dessous.

sudo a2ensite plausible.conf

Après cela, exécutez la commande suivante pour vérifier la configuration d'Apache2 et assurez-vous que vous disposez des configurations correctes. Si vous recevez un message de sortie tel que « Syntaxe OK », cela signifie que votre configuration est correcte.

sudo apachectl configtest

Enfin, redémarrez le service Apache2 via la commande systemctl ci-dessous pour appliquer la nouvelle configuration d'hôte virtuel 'plausible.conf'.

sudo systemctl restart apache2

À ce stade, vous avez terminé la configuration d'Apache2 en tant que proxy inverse pour Plausible Analytics. La prochaine étape consistera à sécuriser le déploiement Plausible avec SSL de Letsencrypt.

Sécuriser des analyses plausibles avec SSL Letsencrypt

Après avoir configuré le proxy inverseur Apache2 pour Plausible Analytics, vous allez maintenant sécuriser Plausible via SSL Letsencrypt. Donc, avant de commencer, assurez-vous que le domaine qui sera utilisé pour le Plausible pointe vers l'adresse IP du serveur. Assurez-vous également d'avoir une adresse e-mail qui sera utilisée pour enregistrer le nom de domaine sur Letsencrypt.

Installez l'outil certbot et le plugin certbot pour Apache2 via la commande apt ci-dessous.

sudo apt install certbot python3-certbot-apache

Saisissez y pour confirmer l'installation et appuyez sur ENTRÉE pour poursuivre l'installation.

Une fois certbot installé, vous pouvez désormais générer des certificats SSL via la commande certbot ci-dessous. Assurez-vous de changer le nom de domaine de votre installation Plausible.

sudo certbot --apache -d plausible.hwdomain.io

Une fois le processus terminé, vous devriez voir le résultat comme celui-ci. Plausible Analytics est désormais sécurisé avec SSL Letsencrypt.

Congratulations! You have successfully enabled https://plausible.hwdomain.io
You should test your configuration at:
https://www.ssllabs.com/ssltest/analyze.html?d=plausible.hwdomain.io
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IMPORTANT NOTES:
 - Congratulations! Your certificate and chain have been saved at:
   /etc/letsencrypt/live/plausible.hwdomain.io/fullchain.pem
   Your key file has been saved at:
   /etc/letsencrypt/live/plausible.hwdomain.io/privkey.pem
   Your cert will expire on 2022-12-10. To obtain a new or tweaked
   version of this certificate in the future, simply run certbot again
   with the "certonly" option. To non-interactively renew *all* of
   your certificates, run "certbot renew"
 - Your account credentials have been saved in your Certbot
   configuration directory at /etc/letsencrypt. You should make a
   secure backup of this folder now. This configuration directory will
   also contain certificates and private keys obtained by Certbot so
   making regular backups of this folder is ideal.
 - If you like Certbot, please consider supporting our work by:
   Donating to ISRG / Let's Encrypt:   https://letsencrypt.org/donate
   Donating to EFF:                    https://eff.org/donate-le

À ce stade, vos Plausible Analytics sont accessibles via une connexion HTTPS sécurisée.

Accéder à des analyses plausibles

Maintenant que Plausible Analytics est sécurisé avec SSL Letsencrypt. Vous pouvez désormais accéder en toute sécurité à votre installation Playsible depuis votre navigateur Web.

Ouvrez votre navigateur Web et visitez le nom de domaine de votre Plausible Analytics (c'est-à-dire : https://plausible.hwdomain.io/).

Dans un premier temps, la page de connexion plausible s'affichera. Saisissez l'adresse e-mail de l'administrateur et le mot de passe de votre Plausible. Cela peut être trouvé dans le fichier de configuration 'plausible-conf.env'.

Le tableau de bord Plausible Analytics devrait maintenant s'afficher si vous disposez de l'utilisateur administrateur et du mot de passe corrects.

Suivi des sites Web avec des analyses plausibles

Dans l'étape suivante, vous apprendrez comment suivre et ajouter le site Web à Plausible Analytics.

Sur le tableau de bord Plausible, cliquez sur « Ajouter un site Web ».

Maintenant, saisissez le nom de domaine que vous souhaitez suivre et sélectionnez l’heure à utiliser. Cliquez ensuite sur « Ajouter un extrait ».

Vous pouvez maintenant ajouter l'extrait JavaScript à votre site Web cible. Cliquez ensuite sur « Commencer à collecter des données ».

Dans la capture d'écran suivante, vous pouvez voir que les domaines sont ajoutés à Plausible Analytics.

Conclusion

Dans ce didacticiel, vous avez installé Plausible Analytics via Docker sur un serveur Ubuntu 22.04. De plus, vous avez installé le serveur Web Apache2 comme proxy inverse pour Plausible Analytics et sécurisé le déploiement via SSL Letsencrypt. Pour l'utilisation de base de Plausible Analytics, vous avez appris à suivre les sites Web via Plausible Analytics.

Désormais, si vous souhaitez continuer, vous pouvez ajouter d'autres sites Web aux Plausible Analytics auto-hébergés qui sont installés sur votre système.