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.
- A website: add the browser snippet to your pages.
- Logs on the same machine: give the file path, such as
/var/log/nginx/access.log. - Logs or events from elsewhere: JSON over HTTP, OpenTelemetry, Fluent Bit, Vector or Cloudflare Workers.
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
- Invite your team in Settings, People, or let them sign in with Google or Microsoft.
- More than one project, or data for longer than 7 days: Core, or try everything for 30 days.