Install HitKeep Self-Hosted Web Analytics

HitKeep is self-hosted web analytics in one Go binary with embedded DuckDB and NSQ. Choose an installation path below based on the machine you already operate. No separate PostgreSQL, Redis, ClickHouse, Kafka, or queue service is required.

If you want the same product without operating upgrades and backups, compare HitKeep Cloud instead.

Choose an installation method

HomebrewThe shortest install and upgrade path on Apple Silicon macOS or x86_64 Linux using the official tap.

Linux binaryRun one process on a VPS, VM, bare-metal server, Raspberry Pi, or restricted network.

Docker ComposeUse a reproducible container deployment with persistent data, archive, and backup volumes.

Kubernetes and HelmInstall the official OCI Helm chart into a cluster you already operate.

Your environment	Start here	What you operate
Apple Silicon macOS or x86_64 Linux	Homebrew	One local binary and its data directory
Linux VPS, VM, bare metal, ARM64, or restricted network	Linux binary	One systemd service and its data directory
Docker-first host	Docker Compose	One container and three persistent volumes
Existing Kubernetes platform	Kubernetes and Helm	A StatefulSet, PVC, Service, and optional Ingress

What every production install needs

Set the browser-visible HITKEEP_PUBLIC_URL.
Generate and persist a strong HITKEEP_JWT_SECRET.
Keep the database, tenant data, archives, and backups on persistent storage.
Put HTTPS in front of HitKeep and configure trusted proxies.
Verify /healthz and /readyz, then complete the setup wizard.
Test a backup and restore before relying on the deployment.

The Configuration Reference contains the current flags, environment variables, defaults, and sensitive-value guidance. Backups and Restore explains the complete data set and restore flow.

After installation

Open your configured public URL. The setup wizard creates the first owner and guides you through adding a site and installing the tracking snippet.