📍 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.gz

Erreurs 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

Déployer Umami sur Coolify avec Postgres : tutoriel complet 2026