StatsRaven

Quickstart

Pick where StatsRaven runs, then follow the same three steps: sign in, send data, ask. Free needs no account and no license.

On a Linux server

For a server that collects data around the clock. Any x86_64 or arm64 machine with Debian 11, Ubuntu 20.04, RHEL 9 or newer.

curl -fsSL https://statsraven.com/install.sh | sh -s -- --service

It installs StatsRaven as a service, starts it and prints a setup token. It listens on 127.0.0.1:7600; put HTTPS in front of it as the install guide shows, or reach it through an SSH tunnel while you try it: ssh -L 7600:127.0.0.1:7600 you@server.

On a Mac

Use Docker Desktop, OrbStack or Colima, then:

docker run -d --name statsraven --restart unless-stopped \
  -p 7600:7600 -v statsraven:/data \
  ghcr.io/umutgokbayrak/statsraven:latest
docker logs statsraven | grep "setup token"

The image runs natively on Apple silicon and Intel Macs.

On Windows

With WSL 2, open an Ubuntu terminal and run:

curl -fsSL https://statsraven.com/install.sh | sh
statsraven --data ~/statsraven serve

The setup token appears in the terminal, and Windows reaches StatsRaven at http://localhost:7600. Leave the terminal open while you use it. With Docker Desktop instead, run the same docker run command as on a Mac.

With Docker anywhere

The Mac command above works on any machine with Docker, on amd64 and arm64. Add -p 4317:4317 for OpenTelemetry over gRPC. Docker Compose, Coolify, Dokploy and similar tools are in the install guide.

1. Sign in

Open http://localhost:7600, or your server's address. Enter the setup token, then your email and a password of at least 12 characters. You are the first admin. The token works once.

StatsRaven opens on Get started with a week of sample data in a demo project, so you can ask questions straight away. The demo does not count as a project and you can remove it.

2. Send your data

On Get started, make a project and pick how data comes in. Each setup has your address and a new token filled in, and a light turns green when the first event arrives.

To check quickly, send one event by hand:

curl -X POST http://localhost:7600/ingest \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"event": "signup", "plan": "pro"}' 

3. Ask

Chat needs an AI provider: add a key in Settings, AI (options). Or skip the key and ask from Claude, Claude Code or Cursor over MCP. Then ask in plain words, for example "How many signups did we get this week, by plan?", and pin the chart you want to keep.

Next