Skip to content

PascaleBeier/hitkeep

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

314 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HitKeep

Privacy-first web analytics you can self-host or run in managed EU/US cloud.

License: MIT Go Version Docker Image (GHCR) Docker Image (Hub) Documentation OpenSSF Best Practices

HitKeep is an open source web analytics platform built for people who want a simpler stack than the usual PostgreSQL, Redis, ClickHouse, and reverse-proxy pileup.

  • Single binary runtime
  • Embedded DuckDB and NSQ with batched ingest writes
  • Privacy-first tracking
  • Goals, funnels, ecommerce, email reports, and API clients
  • Self-hosted or managed cloud with EU/US region choice

Website · Cloud · Live Demo · Docs · API · Releases

HitKeep analytics dashboard — traffic overview, geographic breakdown, goals, funnels, and UTM attribution

Why HitKeep

HitKeep is for teams that want product analytics without adopting a full analytics platform stack.

  • Simple to run: one binary, one data directory, no external database required
  • Efficient write path: NSQ buffers ingest bursts and DuckDB appender batches smooth out disk-heavy per-row inserts
  • Privacy-first by default: cookie-less tracking, Do Not Track support, focused data collection
  • Useful out of the box: traffic analytics with countries/languages audience toggles, top/landing/exit page views, custom events, goals, funnels, ecommerce, UTM attribution, and scheduled email reports
  • Built for teams: passkeys, TOTP, site and team permissions, API clients, share links, and audit visibility
  • Flexible deployment: self-host it yourself or use HitKeep Cloud and still keep the migration path open

Quick Start

Binary

Download the latest release for your system:

wget https://github.com/PascaleBeier/hitkeep/releases/latest/download/hitkeep-linux-arm64
chmod +x hitkeep-linux-arm64
export HITKEEP_JWT_SECRET="replace-this-with-a-long-random-string"
./hitkeep-linux-arm64 -public-url="http://localhost:8080"

Open http://localhost:8080 and create your first account.

Docker

services:
  hitkeep:
    image: pascalebeier/hitkeep:latest
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - hitkeep_data:/var/lib/hitkeep/data
    environment:
      HITKEEP_JWT_SECRET: replace-this-with-a-long-random-string
    command:
      - "-public-url=http://localhost:8080"

volumes:
  hitkeep_data: {}
docker compose up -d

For production setup, reverse proxies, SMTP, systemd, Kubernetes, S3 archiving, and every configuration flag, use the docs instead of this README:

Tracking Snippet

Once your instance is running and a site is created, add:

<script async src="https://your-hitkeep-instance.com/hk.js"></script>

Custom event example:

<script>
  window.hk = window.hk || {};
  window.hk.event?.("signup", { plan: "pro", source: "landing-page" });
</script>

Tracker options, ecommerce events, custom events, and advanced tracking examples live here:

Product Tour

See more screenshots

Comparison

HitKeep period-over-period comparison with delta badges and overlay charts

Events

HitKeep custom event analytics with timeseries chart and property breakdown

Goals

HitKeep goals and conversion tracking

Funnels

HitKeep multi-step funnel analytics

Ecommerce

HitKeep ecommerce analytics with revenue KPIs, chart, top products, and revenue sources

Email Reports

HitKeep scheduled email reports

API Clients

HitKeep API client management

Create Team

HitKeep create team dialog with name and logo setup

Admin Users

HitKeep administration users view with roles and security controls

Team Overview

HitKeep team administration overview

Documentation

The maintained reference lives on hitkeep.com.

Cloud

HitKeep Cloud is live.

If you want the same product without running it yourself, start here:

Development

Prerequisites:

  • Go 1.26+
  • Node.js 24+
  • Make

Build from source:

git clone https://github.com/pascalebeier/hitkeep.git
cd hitkeep
make build
./hitkeep

Contributor docs and project guides:

License

Distributed under the MIT License. See LICENSE.

About

Privacy-first web analytics you can self-host or run in managed EU/US cloud.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Sponsor this project

 

Packages