Installare HitKeep per web analytics self-hosted

HitKeep offre web analytics self-hosted in un unico binario Go con DuckDB e NSQ integrati. Scegli qui sotto il metodo di installazione più adatto all’infrastruttura che già gestisci. Non servono PostgreSQL, Redis, ClickHouse, Kafka né un servizio di code separato.

Se preferisci lo stesso prodotto senza dover gestire aggiornamenti e backup, confronta invece HitKeep Cloud.

Scegli un metodo di installazione

HomebrewIl percorso più breve per installare e aggiornare HitKeep su macOS Apple Silicon o Linux x86_64 tramite il tap ufficiale.

Binario LinuxEsegui un solo processo su VPS, VM, server bare metal, Raspberry Pi o reti con accesso limitato.

Docker ComposeUsa una distribuzione container riproducibile con volumi persistenti per dati, archivi e backup.

Kubernetes e HelmInstalla il chart Helm OCI ufficiale in un cluster che gestisci già.

Il tuo ambiente	Inizia da qui	Cosa gestisci
macOS Apple Silicon o Linux x86_64	Homebrew	Un binario locale e la relativa directory dati
VPS Linux, VM, bare metal, ARM64 o rete con accesso limitato	Binario Linux	Un servizio systemd e la relativa directory dati
Host basato su Docker	Docker Compose	Un container e tre volumi persistenti
Piattaforma Kubernetes esistente	Kubernetes e Helm	Uno StatefulSet, un PVC, un Service e un Ingress opzionale

Usi un reverse proxy?

Configura i proxy attendibili prima di inoltrare il traffico di produzione tramite Caddy, nginx, Traefik, un ingress controller o un bilanciatore di carico. In questo modo gli IP dei client, i metadati geografici, le esclusioni e i limiti di frequenza restano corretti.

Requisiti di ogni installazione in produzione

1. Imposta HITKEEP_PUBLIC_URL sull’URL visibile nel browser.
2. Genera e conserva in modo persistente un valore robusto per HITKEEP_JWT_SECRET.
3. Mantieni database, dati dei tenant, archivi e backup su storage persistente.
4. Termina HTTPS davanti a HitKeep e configura i proxy attendibili.
5. Verifica /healthz e /readyz, quindi completa la procedura di configurazione.
6. Prova un backup e un ripristino prima di affidarti alla distribuzione.

Il riferimento di configurazione contiene flag, variabili d’ambiente, valori predefiniti e indicazioni per i dati sensibili. Backup e ripristino descrive l’insieme completo dei dati e la procedura di ripristino.

Dopo l’installazione

Apri l’URL pubblico configurato. La procedura guidata crea il primo proprietario e ti accompagna nell’aggiunta di un sito e nell’installazione dello snippet di tracciamento.

Passaggi successivi:

• Comprendere e verificare il tracciamento
• Configurare i proxy attendibili
• Pianificare backup e ripristino
• Ottimizzare prestazioni e memoria