Installer HitKeep, solution d’analyse web auto-hébergée

HitKeep est une solution d’analyse web auto-hébergée réunie dans un seul binaire Go, avec DuckDB et NSQ intégrés. Choisissez ci-dessous la méthode d’installation adaptée à la machine que vous exploitez déjà. Aucun service PostgreSQL, Redis, ClickHouse, Kafka, de cache ou de file d’attente séparé n’est nécessaire.

Si vous préférez utiliser le même produit sans gérer les mises à niveau ni les sauvegardes, comparez plutôt les offres HitKeep Cloud.

Choisir une méthode d’installation

HomebrewLa méthode la plus courte pour installer et mettre à niveau HitKeep sur macOS Apple Silicon ou Linux x86_64 avec le dépôt officiel.

Binaire LinuxExécutez un seul processus sur un VPS, une machine virtuelle, un serveur physique, un Raspberry Pi ou un réseau restreint.

Docker ComposeDéployez un conteneur reproductible avec des volumes persistants pour les données, les archives et les sauvegardes.

Kubernetes et HelmInstallez le chart Helm OCI officiel dans un cluster que vous exploitez déjà.

Votre environnement	Commencez ici	Ce que vous exploitez
macOS Apple Silicon ou Linux x86_64	Homebrew	Un binaire local et son répertoire de données
VPS Linux, machine virtuelle, serveur physique, ARM64 ou réseau restreint	Binaire Linux	Un service systemd et son répertoire de données
Hôte privilégiant Docker	Docker Compose	Un conteneur et trois volumes persistants
Plateforme Kubernetes existante	Kubernetes et Helm	Un StatefulSet, un PVC, un Service et, au besoin, un Ingress

Vous utilisez un proxy inverse ?

Configurez les proxys de confiance avant d’envoyer du trafic de production via Caddy, nginx, Traefik, un contrôleur d’Ingress ou un répartiteur de charge. Les adresses IP clientes, les métadonnées géographiques, les exclusions et la limitation de débit resteront ainsi correctes.

Prérequis communs à toute installation en production

1. Définissez HITKEEP_PUBLIC_URL sur l’URL visible dans le navigateur.
2. Générez une valeur forte pour HITKEEP_JWT_SECRET et conservez-la durablement.
3. Stockez la base de données, les données des espaces, les archives et les sauvegardes sur un support persistant.
4. Placez HitKeep derrière HTTPS et configurez les proxys de confiance.
5. Vérifiez /healthz et /readyz, puis terminez l’assistant de configuration.
6. Testez une sauvegarde et une restauration avant de dépendre de ce déploiement.

La référence de configuration répertorie les options, variables d’environnement, valeurs par défaut et recommandations actuelles concernant les données sensibles. Le guide Sauvegarde et restauration décrit l’ensemble complet des données et le processus de restauration.

Après l’installation

Ouvrez l’URL publique configurée. L’assistant crée le premier propriétaire, puis vous aide à ajouter un site et à installer le script de suivi.

Étapes suivantes :

• Comprendre et vérifier le suivi
• Configurer les proxys de confiance
• Planifier les sauvegardes et la restauration
• Optimiser les performances et la mémoire