📍 Article principal du cluster : Umami Analytics 2026 : guide complet.
Vingt minutes pour installer Umami sur Hetzner CX22. Méthode validée chez agences digitales et e-commerces francophones.
Prérequis
- Hetzner CX22 ou plus petit (Umami léger).
- Coolify v4.
- Domaine :
analytics.votre-entreprise.com. - Niveau attendu : intermédiaire.
- Temps estimé : 20-30 minutes.
Étape 1 — DNS
dig +short analytics.votre-entreprise.com # IP VPSÉtape 2 — Service Umami dans Coolify
Resources → + New → Service → rechercher « Umami ». Coolify déploie le template officiel avec Postgres 16.
Étape 3 — Variables d’environnement
DATABASE_URL=postgres://umami:password@umami-db:5432/umami
DATABASE_TYPE=postgresql
APP_SECRET=générer-32-octets-base64
TRACKER_SCRIPT_NAME=script.js
DISABLE_TELEMETRY=1
LOG_QUERY=0Étape 4 — Domaine HTTPS
Onglet Domains : https://analytics.votre-entreprise.com. Force HTTPS.
Étape 5 — Lancer Deploy
Coolify pull umamisoftware/umami + postgres. Comptez 2-3 minutes.
Étape 6 — Premier login
Ouvrir https://analytics.votre-entreprise.com. Login par défaut : admin / umami. Changer immédiatement password fort.
Étape 7 — Premier site
Settings → Websites → + Add → saisir nom + domain. Umami génère Website ID UUID. Copier snippet.
Étape 8 — Coller snippet sur site
<script defer src="https://analytics.votre-entreprise.com/script.js"
data-website-id="VOTRE_UUID"></script>Visiter site, attendre 30s, retourner Umami → Dashboard → site → real-time visiteurs.
Étape 9 — Création users supplémentaires
Settings → Users → + Add. Roles : admin, view-only. Distribuer login aux clients agence pour reporting.
Étape 10 — Sauvegardes
# Cron quotidien
docker exec umami-db pg_dump -U umami umami | gzip > /tmp/umami-pg.gz
restic backup /tmp/umami-pg.gz
rm /tmp/umami-pg.gzErreurs fréquentes
| Erreur | Cause | Solution |
|---|---|---|
| 404 sur /script.js | TRACKER_SCRIPT_NAME incorrect | Vérifier env var |
| Adblockers bloquent | Domain umami.is reconnu | Self-host ne devrait pas avoir ce souci |
| Postgres connect timeout | Réseau Docker | Vérifier service umami-db up |
| Login admin/umami refuse | Premier setup pas terminé | Restart Umami container |
| Stats à 0 | data-website-id mal copié | Recopier UUID exact |
| HTTPS Let’s Encrypt échoue | Port 80 bloqué | UFW allow 80 |
Adaptation au contexte ouest-africain
Trois précisions. Latence Hetzner FSN1 : 95 ms vers Dakar acceptable pour analytics async. Multi-clients agence : créer un dashboard par client en mode view-only pour reporting transparent. Conformité CDP/ARTCI : Umami zéro données personnelles, conforme natif.
Tutoriels frères
FAQ
Performance VPS petit ? CX11 (1 vCPU, 2 Go) tient 10 sites + 100k pageviews/mois.
Mises à jour ? Coolify Pull image + Redeploy.
Multi-domaine ? Oui, illimité dans une instance.
Plugins ? Pas de plugin system. Customisation via fork.
Multi-tenant SaaS ? Workaround : un Umami par client.
Pour aller plus loin
- 🔝 Retour au pilier : Guide complet Umami 2026
- Documentation : umami.is/docs/install
