Counterscale

Counterscale records pageviews in Workers Analytics Engine and shows per-site traffic in a dashboard. A CLI wizard deploys it, and a nightly job copies the data to R2 so history outlasts Analytics Engine's 90-day retention.

Sites load tracker.js from the deployment, or use the @counterscale/tracker npm package in the browser or from server code, and each pageview is stored under a site ID. The dashboard shows pageviews, referrers and engagement for each site without cookies or browser fingerprinting. The long-term copy is written to R2 as Apache Arrow files of daily rollups. It is on by default, and the CLI can switch it off. The same CLI that installs Counterscale later rolls the dashboard password and turns authentication or R2 storage on and off. For most releases, re-running install upgrades a deployment and keeps its data; major versions can need extra steps.

Built for: Developers and site owners who want basic, privacy-friendly web analytics running in their own Cloudflare account

What you can use it for

• Track pageviews across several websites without cookies
• Record pageviews from backend code with the server-side tracker
• Keep a long-term analytics archive in your own R2 bucket
• Replace a hosted analytics script with one you run yourself

Deploy

• CLI

  Branch main

  Enable Analytics Engine in the Cloudflare dashboard and create an API token with Account Analytics permission first. The installer asks for the token and an optional dashboard password.

  npx wrangler login
  npx @counterscale/cli@latest install

  Copy
  Docs

The CLI wizard deploys the Worker and stores its secrets. On a first deploy, the workers.dev subdomain can take a few minutes to go live.

What it needs to run

• Analytics EnginemetricsDataset
• R2 bucketscounterscale-daily-rollups

Good to know

The dashboard shows only the last 90 days, the retention limit of Workers Analytics Engine. Analytics Engine also samples high-volume writes and queries. The installer needs macOS or Linux and Node 20 or newer. First-time Workers users have to create a Worker before Analytics Engine can be enabled. Local development has no test database: writes are dropped and reads come from production data. Without the optional password, the dashboard is public.

Cost on Cloudflare

Where this comes from

• Repositoryhttps://github.com/benvinegar/counterscale
• App websitehttps://counterscale.dev
• Demohttps://demo.counterscale.dev/dashboard
• Documentationhttps://github.com/benvinegar/counterscale#installation

An alternative to Fathom Analytics, GoatCounter, Plausible Analytics, Vercel Web Analytics.