Plug it in, real ones only.

A short list on purpose. Each item below exists in the repository and has a docs page.

API docsFeatures

Send data in

Tracker script

One script tag. Per-site settings switch on outbound links, downloads, forms, 404s, hash routing, clicks, Web Vitals and heatmaps.

JavaScript package

@supermetry/tracker is a typed wrapper that loads the script from app code. It is private and unpublished for now; install it from a source checkout.

Events API

Send pageviews and custom events from a trusted server over HTTP.

First-party paths

Serve the tracker and endpoint from your own domain to get past ad blockers.

Read data out

Stats API

Summary, timeseries, breakdowns and realtime, behind scoped API keys.

Management API

Create sites, goals and funnels through the versioned public API.

MCP server

Connect an AI assistant to your analytics with a read-scoped key limited to the sites you choose.

CSV export

Every report streams as CSV.

Notify and import

Webhook, Slack, Discord

Alert notifications go to a generic webhook, a Slack incoming webhook or a Discord webhook.

Email reports and alerts

Scheduled reports and alerts by email through your own SMTP server.

Plausible and Umami

Bring in daily aggregates from a Plausible ZIP or an Umami CSV.

Run it

PostgreSQL

The only database. Version 14 or later.

Docker, systemd, binary

A Dockerfile and Compose file, release binaries, a systemd unit and an installer.

Prometheus metrics

A protected metrics endpoint plus a data health page.

GeoIP and S3

A bundled DB-IP country database with optional GeoLite2 detail, and S3-compatible storage for replays.

Missing one?

Tell us what you connect to. The project is open, so you can also add it.

Get in touchContribute