HitKeep

Privacy-first analytics for humans and AI agents, self-hosted or in EU/US cloud.

HitKeep is open source web analytics for teams that want useful product reporting without running PostgreSQL, Redis, ClickHouse, or a separate queue.

• Single Go binary with embedded DuckDB and NSQ
• Cookie-less tracker by default, with Do Not Track support
• Traffic, events, goals, funnels, ecommerce, UTM, and email reports
• Google Search Console aggregate import for query, page, country, and device reporting
• AI visibility analytics for crawler fetches and AI-referred visits
• Scoped API clients and a read-only MCP analytics server for approved agents
• Self-hosted or managed cloud with EU/US region choice

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

Why HitKeep

HitKeep is for teams that need clear web analytics, conversion reporting, and AI-era search visibility in one small operational footprint.

• Low-ops self-hosting: one binary, one data directory, embedded DuckDB and NSQ
• Useful reports: top pages, landing and exit pages, events, goals, funnels, ecommerce, UTM attribution, and Search Console aggregates
• Privacy defaults: focused data collection, cookie-less tracking, and DNT handling
• AI visibility: server-side crawler fetch analytics, AI-referred visits, and correlation reports
• Team controls: passkeys, TOTP, site/team permissions, share links, audit logs, API clients, and read-only MCP access
• Deployment choice: run it yourself or use managed cloud in the EU or US

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:

• Installation guides
• Configuration reference
• Cloud documentation

Local Development

Contributors can run the full hot-reload development stack with Docker:

make dev-docker-seed

This starts the Go backend, Angular dashboard, Mailpit, and seeded demo data. Open http://localhost:4200 and sign in with [email protected] / demo1234. See CONTRIBUTING.md for Docker-only and native workflows.

Track Your Site

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:

• Tracking docs
• Custom events
• Ecommerce analytics
• Google Search Console integration
• MCP analytics access
• WordPress integration
• AI visibility analytics
• CloudFront AI crawler tracking
• AI chatbot analytics
• REST API reference
• Compliance overview

Product Tour

Documentation

The maintained reference lives on hitkeep.com.

• Getting started
• Installation
• Configuration
• REST API reference
• Compliance
• Comparison pages

Cloud

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

• Start in the EU
• Start in the US
• Cloud overview

Development

Prerequisites:

• Go 1.26+
• Node.js 24+
• Make
• A working C toolchain for DuckDB builds

Build from source:

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

For day-to-day development:

make dev

This starts the Go backend with live reload and the Angular dashboard on http://localhost:4200.

For a seeded local workspace with demo data:

make dev-seed

Contributor docs and local development guides:

• Contributing guide
• Dashboard development notes
• Changelog

License

Distributed under the MIT License. See LICENSE.