Install HitKeep Self-Hosted Web Analytics

Questi contenuti non sono ancora disponibili nella tua lingua.

HitKeep is self-hosted web analytics with one Go binary, embedded DuckDB, and embedded NSQ. It runs on your infrastructure: a $6/month VPS, a VM, a bare-metal server, a Kubernetes cluster with Helm, or a restricted internal network.

Use this page when you want analytics under your control without adding PostgreSQL, Redis, ClickHouse, Kafka, or a hosted analytics vendor. If you want the same product without managing upgrades, backups, SMTP, or servers, start with HitKeep Cloud instead.

Choose the deployment method that fits your environment and security requirements:

Environment	Recommended path	Why
Small VPS, VM, bare metal, Raspberry Pi, or restricted network	Single Binary	One process and one data directory are easiest to operate and back up
Docker-first server with an existing reverse proxy	Docker Compose	Provides predictable volumes and service wiring without a larger platform
Existing Kubernetes platform	Kubernetes and Helm	Fits teams that already operate persistent workloads and ingress
Any deployment behind a proxy or load balancer	Trusted Proxies	Required for correct client IP handling, rate limits, exclusions, and geo metadata

Single BinaryDownload and run directly on bare metal or VMs. Best for low-resource Linux servers, Raspberry Pi, and restricted networks.

Docker ComposePre-configured networking and persistent storage volumes. The fastest path from zero to production with a reverse proxy.

Kubernetes and HelmOfficial Helm chart or plain StatefulSet manifest with persistent storage for DuckDB data, QR assets, archives, and backups.

Trusted ProxiesRequired if running behind Caddy, Traefik, nginx, or a cloud load balancer. Ensures real client IPs are used for analytics and rate limiting.

After Installation

Once HitKeep is running, the setup wizard guides you through creating the first admin user and adding your first site. Paste the tracking snippet into your site’s <head> and analytics begins flowing into your database immediately.

The browser snippet records normal pageviews, automatic events, and AI-referred human visits. If you also need AI crawler fetches, add a server-side feed after the first site is working. If you need approved assistants or internal reporting tools to query aggregate analytics, enable MCP, create a scoped API client token, and install the HitKeep Agent Skills where your assistant supports them.

All data is stored under HitKeep’s data directory on your server. In single-team installs that is just hitkeep.db; multiteam installs also include tenants/*/hitkeep.db. Back up the full directory tree. Export it any time in open formats. Move it to any platform. It’s yours.

Prefer managed infrastructure with explicit region choice? HitKeep Cloud → runs HitKeep in your chosen managed region: EU (Frankfurt) or US (Virginia).

Next paths: