pascalebeier/hitkeep repository overview

⁠HitKeep

AI-native, sovereign, privacy-first web analytics in one binary.

HitKeep is a 100% open-source web analytics platform licensed under MIT. Analyze traffic, conversions, ecommerce, Search Console, Web Vitals, AI crawlers, AI referrals, and chatbot outcomes—without operating a separate database, queue, or cache.

Website⁠ · Documentation⁠ · Source code⁠ · Managed cloud⁠

⁠Why HitKeep

• 100% open source: Custom tracking domains, team SSO, exports, APIs, webhooks, permissions, and AI analytics are part of the public MIT-licensed product.
• Full data sovereignty: Keep analytics on your infrastructure and export your data in open formats whenever you need it.
• AI-native analytics: Measure AI crawler activity, AI-referred visitors, and chatbot outcomes as separate signals. Ask AI answers questions using cited aggregate evidence.
• Privacy by default: Cookieless tracking, Do Not Track support, and no cross-site visitor identity.
• One small stack: The Go application embeds its Angular dashboard, DuckDB storage, and NSQ queue.

The image runs as a non-root user, includes a built-in health check, and supports linux/amd64 and linux/arm64.

⁠Quick Start

Create a long random secret in your password manager, replace the placeholder below, and start HitKeep:

docker run -d \
  --name hitkeep \
  --restart unless-stopped \
  -p 8080:8080 \
  -v hitkeep_data:/var/lib/hitkeep/data \
  -e HITKEEP_PUBLIC_URL=http://localhost:8080 \
  -e HITKEEP_JWT_SECRET='replace-with-a-long-random-secret' \
  pascalebeier/hitkeep:latest

Open http://localhost:8080⁠ and create the first account.

Keep HITKEEP_JWT_SECRET private and unchanged across restarts. The named Docker volume preserves the DuckDB database, archives, and backups when the container is replaced.

For a production deployment with HTTPS, reverse-proxy configuration, and separate data volumes, use the maintained Docker Compose guide⁠.

⁠Configuration

See the configuration reference⁠ for email, social sign-in, Search Console, custom tracking domains, AI providers, MCP, backups, and other settings.

Health endpoints are available at:

• /healthz for process health
• /readyz for readiness

⁠Image Tags

• latest — latest stable release
• X.Y.Z — exact release; recommended for repeatable production deployments
• X.Y — latest patch release in a minor series
• X — latest release in a major series
• snapshot or main — current development build; not recommended for production

Browse all available tags on Docker Hub⁠ and review GitHub Releases⁠ before upgrading.

Back up persistent data before an upgrade. See Backups and Restore⁠ for the supported workflow.

⁠Track Your First Site

Create a site in HitKeep, then add the tracker to your website:

<script async src="https://analytics.example.com/hk.js"></script>

Replace analytics.example.com with your HitKeep domain. Pageviews, outbound clicks, downloads, and form submissions begin flowing automatically.

Use custom events⁠ for actions such as signups, purchases, and qualified leads.

⁠Documentation and Support

• Installation⁠
• Configuration⁠
• REST API⁠
• Source code⁠
• Issue tracker⁠
• Security policy⁠

Want to support independent open-source analytics? Fund HitKeep on GitHub Sponsors⁠ or make a one-time contribution⁠.

⁠License

HitKeep is distributed under the MIT License⁠.