tarsier docs
Sections

Start here

Installation

Tarsier is self-hosted: the server runs on your own Cloudflare account, so your analytics live on infrastructure you control.

What you need

  • A Cloudflare account, free or paid.
  • Node 20 or newer, and pnpm 9 or newer.
  • A Cloudflare API token with Account Analytics permissions.

The short version

  1. Create a Cloudflare account and verify your email.
  2. Enable Analytics Engine under Storage & Databases. (You can dismiss the dataset prompt — Tarsier creates its own.)
  3. Create an API token with Account Analytics permissions and keep it somewhere safe.
  4. Clone the project, install dependencies, and deploy with Wrangler.

Costs

The stack is Workers plus Analytics Engine, and the profile is near-zero: Cloudflare's free tier can comfortably cover tens of thousands of hits per day. Traffic history rolls across a 90-day lookback.

The full walkthrough, with screenshots, lives in the project README — start there and come back when the dashboard loads.