À propos du projet

Umami se présente comme une plateforme d'analyse axée sur la confidentialité qui regroupe le trafic, les campagnes, le comportement, les conversions et les revenus en un seul endroit. Le projet souligne qu'il n'utilise ni cookies ni techniques de surveillance, et peut être exploité soit en auto-hébergement, soit via une offre cloud hébergée. Une démo publique est liée depuis le README, et les canaux de support du projet incluent GitHub, Twitter, LinkedIn et Discord. Le code est publié sous licence MIT. L'installation à partir des sources nécessite un serveur avec Node.js 18.18 ou ultérieur et une base de données PostgreSQL (version 12.14 ou ultérieure). Le flux documenté consiste à cloner le dépôt, installer les dépendances avec pnpm, créer un fichier `.env` contenant une chaîne de connexion `DATABASE_URL`, exécuter le build, puis démarrer l'application. L'étape de build crée les tables de la base de données lors de la première installation et initialise également un utilisateur de connexion avec le nom d'utilisateur `admin` et le mot de passe `umami`. Par défaut, l'application démarre sur `http://localhost:3000`, la documentation note donc que vous devrez généralement proxy-iser les requêtes depuis un serveur web ou modifier le port pour la servir directement. Plusieurs options d'environnement sont documentées. `API_URL` peut modifier l'URL de base utilisée pour les appels API internes de l'interface utilisateur ; les chemins relatifs sont servis sous `BASE_PATH`, tandis que les URL absolues sont proxy-isées via la route locale `/api`. `TWO_FACTOR_ENCRYPTION_KEY`, une chaîne hexadécimale de 64 caractères générée par exemple avec `openssl rand -hex 32`, active l'authentification à deux facteurs ; tant qu'elle n'est pas définie, l'authentification à deux facteurs est indisponible et ne peut être exigée. Pour le déploiement conteneurisé, le projet publie des images Docker et fournit un fichier Docker compose qui exécute Umami conjointement avec une base de données PostgreSQL. Les mises à jour sont gérées soit en récupérant les sources, en réinstallant les dépendances et en reconstruisant, soit en récupérant de nouvelles images et en recréant les conteneurs avec Docker compose. Un guide de démarrage détaillé est hébergé sur le site de documentation du projet.