Plausible Analytics peut être hébergé sur votre propre serveur avec Community Edition. Pour une nouvelle installation, utilisez le dépôt officiel de cette édition et les instructions de la version retenue. L’ancienne procédure basée sur le dépôt hosting et ses fichiers ne doit pas être appliquée telle quelle.
Préparer le serveur et la sauvegarde
Vérifiez les prérequis de la version : Docker, Docker Compose, architecture du processeur et ressources nécessaires aux services. Prévoyez un domaine, HTTPS, de l’espace pour les statistiques et une politique de sauvegarde.
L’auto-hébergement vous confie aussi les mises à jour, la disponibilité et la restauration. Pour dimensionner la machine, voir le rôle et les limites du swap sur un VPS.
Partir d’une version identifiée de Community Edition
Dans le dépôt officiel Plausible Community Edition, choisissez une version publiée et suivez son README. Téléchargez les fichiers de cette même version : ne mélangez pas le fichier Compose d’une édition avec l’image d’une autre.
Configurez localement BASE_URL et générez une valeur unique pour SECRET_KEY_BASE selon les instructions du projet. Conservez les secrets dans la configuration privée du serveur, avec des accès restreints. Ne publiez ni leur valeur ni le contenu complet des fichiers d’environnement.
Exposition directe ou reverse proxy existant
Le guide officiel propose une exposition HTTP/HTTPS et décrit aussi les adaptations nécessaires derrière un reverse proxy. Choisissez une seule stratégie cohérente : un serveur Nginx déjà en écoute sur les ports publics peut entrer en conflit avec un autre service qui tente de les occuper.
Si Nginx termine HTTPS, vérifiez les ports du service interne, les noms d’hôte et les en-têtes transmis. N’exposez pas les bases de données au public pour permettre l’accès au tableau de bord.
Démarrer et contrôler les services
Après configuration conforme aux fichiers de votre version, lancez les services depuis le dossier du projet :
docker compose up -d
docker compose psExaminez les journaux en cas d’échec. Ouvrez ensuite votre instance, créez le compte initial et ajoutez un site. Le code de mesure doit provenir de cette instance : une ancienne URL de script peut ne plus correspondre à votre déploiement.
Vérifier la collecte
- Ouvrir une page de test portant le script prévu.
- Vérifier la requête de collecte et sa réponse.
- Confirmer l’apparition de la visite dans les statistiques.
- Contrôler les règles de cache, de proxy et les bloqueurs éventuels.
- Tester les événements dont le site a réellement besoin.
Si vous utilisez SRI, un hash doit correspondre exactement au script servi. Lors d’une mise à jour du script, vérifiez l’intégrité et son chargement plutôt que de conserver un hash obsolète.
Mettre à niveau une installation existante
Avant toute modification, identifiez les versions installées et lisez les notes de migration. Sauvegardez la configuration, PostgreSQL et ClickHouse, puis testez la restauration. Une montée de version peut imposer des étapes intermédiaires.
La sauvegarde doit rester indépendante du serveur. Consultez la stratégie 3-2-1 et surveillez l’espace occupé sur le disque.
Désinstaller sans toucher aux autres applications
Inventoriez les services et volumes appartenant à cette instance avant toute suppression. Ne supprimez pas les répertoires globaux de Docker ou de containerd : ils peuvent contenir les données d’autres applications. Conservez une sauvegarde vérifiée avant de retirer les seules ressources devenues inutiles.
Documentation
Plausible Community Edition : installation et versions ; wiki officiel pour l’exploitation et les mises à niveau.
