HitKeep

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

100% open source under MIT, HitKeep unifies traffic, conversions, Search Console, and AI visibility with custom tracking domains, SSO, open exports, and no separate database, queue, or cache.

Self-host · Documentation · Cloud · Website

Latest release Continuous integration status MIT license Docker pulls OpenSSF Best Practices badge

![HitKeep dashboard showing traffic metrics, a 30-day comparison chart, and analytics navigation](./.github/assets/dashboard-overview.png) ## Why HitKeep - **100% open source.** The complete product is MIT-licensed. Custom tracking domains and team SSO live in the same public codebase—not in a separate proprietary edition. - **Full data sovereignty.** Self-host one Go binary with embedded DuckDB and NSQ, or export your data in open formats. Complete takeout, APIs, webhooks, share links, and permissions keep the data useful outside HitKeep. - **AI-native analytics.** HitKeep treats AI as a first-class traffic channel: crawler fetches, AI-referred visits, and chatbot outcomes remain distinct. Ask AI uses cited aggregate evidence, while read-only MCP gives approved assistants governed analytics access. - **Privacy by default.** The browser tracker sets no analytics cookies, respects Do Not Track, and collects focused website analytics without building a cross-site identity. - **Reporting that reaches the outcome.** Follow acquisition through pages, automatic and custom events, goals, funnels, ecommerce revenue, UTM and QR campaigns, Search Console, and Web Vitals. Self-host the complete open-source product, or use [HitKeep Cloud](https://hitkeep.com/cloud) in a managed EU or US region when you do not want to operate it yourself. HitKeep is web-focused. It favors aggregate traffic and conversion evidence over visitor profiles, session replay, mobile SDKs, or built-in experimentation. The result is a smaller collection boundary and operating surface without stopping at a basic pageview counter. ## Quick Start On Apple silicon macOS or x86_64 Linux, install HitKeep with Homebrew: ```bash brew install HitKeep/hitkeep/hitkeep hitkeep --version ``` Follow the [Homebrew installation guide](https://hitkeep.com/guides/installation/homebrew/) to configure and start HitKeep. On Linux ARM64, use the published ARM64 binary or Docker instead. For a production-oriented self-hosted setup, download the Docker Compose file and environment template: ```bash mkdir hitkeep && cd hitkeep curl -fsSLo compose.yml https://raw.githubusercontent.com/HitKeep/hitkeep/main/examples/compose.yml curl -fsSLo .env https://raw.githubusercontent.com/HitKeep/hitkeep/main/examples/.env.example ``` Open `.env` and replace `paste-the-generated-value-here` with a long random value from your password manager. Then start HitKeep: ```bash docker compose up -d ``` Open [http://localhost:8080](http://localhost:8080) and create the first account. Keep `.env` private and retain the same secret across restarts. Before exposing an instance publicly, follow the [Docker Compose guide](https://hitkeep.com/guides/installation/docker-compose/) for HTTPS and trusted proxies, then review [backups](https://hitkeep.com/guides/data/backups-and-restore/) and the [configuration reference](https://hitkeep.com/reference/configuration/). For a native Linux service, download an AMD64 or ARM64 binary from [GitHub Releases](https://github.com/HitKeep/hitkeep/releases) and follow the [binary installation guide](https://hitkeep.com/guides/installation/binary/). ## Track Your First Site Create a site in the dashboard, then add the tracker to your pages: ```html ``` Pageviews and supported automatic interaction events—outbound clicks, file downloads, and form submissions—start flowing immediately. Use the [custom events guide](https://hitkeep.com/guides/tracking/custom-events/) for product-specific actions such as signups, purchases, or qualified leads. ## Explore HitKeep
See AI visibility, ecommerce, Search Console, Ask AI, and Assistants ### AI visibility ![HitKeep AI visibility report separating crawler fetches, AI referrals, and related activity](./.github/assets/analytics-ai-visibility.png) ### Ecommerce ![HitKeep ecommerce analytics showing revenue KPIs, trends, top products, and revenue sources](./.github/assets/analytics-ecommerce.png) ### Search Console ![HitKeep Search Console report showing clicks, impressions, click-through rate, position, and query trends](./.github/assets/analytics-search-console.png) ### Ask AI ![HitKeep Ask AI answer with completed analytics tools, cited evidence, a table, and a safe dashboard action](./.github/assets/feature-ask-ai-answer.png) ### Assistants ![HitKeep Assistants setup showing the MCP endpoint, connection guides, and OAuth access controls](./.github/assets/mcp.png)
## Documentation, Community, and Support Find answers in the documentation, report reproducible bugs through GitHub Issues, and disclose vulnerabilities privately through the security policy.
Contributor quick path Run `./hk setup`, then start seeded development with `./hk dev --seed` or use `./hk dev --detach`. Capture product proof with `./hk screenshot`; inspect `./hk catalog commands --output json` and `./hk catalog configuration --output json` instead of copying mutable workflow facts. Validate with `./hk qa pr`. The Compose stack and complete workflow live in [CONTRIBUTING.md](./CONTRIBUTING.md).
- **Operate:** [Installation](https://hitkeep.com/guides/installation/) · [Configuration](https://hitkeep.com/reference/configuration/) · [REST API](https://hitkeep.com/api/) · [Goals](https://hitkeep.com/guides/analytics/goals/) · [Funnels](https://hitkeep.com/guides/analytics/funnels/) - **Evaluate:** [Comparison library](https://hitkeep.com/vs/) · [Compliance](https://hitkeep.com/compliance/overview/) · [Releases](https://github.com/HitKeep/hitkeep/releases) · [Changelog](./CHANGELOG.md) - **Contribute:** [Contributor guide](./CONTRIBUTING.md) · [Security policy](./SECURITY.md) · [Issues](https://github.com/HitKeep/hitkeep/issues) - **Support open source:** [Fund HitKeep on GitHub Sponsors](https://github.com/sponsors/PascaleBeier) or [make a one-time contribution](https://www.paypal.me/kreuztal). ## License HitKeep is distributed under the [MIT License](./LICENSE). ### DuckDB extensions HitKeep includes the DuckDB extensions required for S3 backups and XLSX exports. It does not download extensions at startup. On first use, bundled files are extracted into `HITKEEP_DATA_PATH/.duckdb/extensions`; this directory must be writable by the process running HitKeep and reside on a mount without `noexec`. The cache is disposable and can be recreated without network access. No `HOME` override or separate extension installation is needed for binary, Homebrew, or container deployments. Contributor instructions for DuckDB upgrades are in [the extension bundle documentation](duckdbextensions/README.md).