StatsRaven

Install

StatsRaven is one program with no database to set up. It runs on a Linux server, x86_64 or arm64, with glibc 2.31 or newer: Debian 11, Ubuntu 20.04, RHEL 9 and anything newer. On a Mac or an older Linux, use Docker. On Windows, use WSL 2 or Docker Desktop. The quickstart has each of them step by step.

On a Linux server

This downloads the latest release, checks it and puts statsraven in /usr/local/bin.

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

To also run it as a service that starts with the server, add --service. It creates a statsraven user, keeps the data in /var/lib/statsraven, starts the service and prints the setup token.

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

The service listens on 127.0.0.1:7600. Put a web server with HTTPS in front of it, as below, to reach it from other machines. Logs: journalctl -u statsraven -f.

With Docker

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 on amd64 and arm64, as a user without root rights, with its data in the /data volume. Port 4317 takes OpenTelemetry over gRPC if you publish it too. Or with Docker Compose, in a compose.yml:

services:
  statsraven:
    image: ghcr.io/umutgokbayrak/statsraven:latest
    restart: unless-stopped
    ports:
      - "7600:7600"
    volumes:
      - statsraven:/data
volumes:
  statsraven:

Coolify, Dokploy, CapRover, Easypanel, Unraid and Umbrel run the same image: give it a volume at /data and point the domain at port 7600.

First sign-in

The first start prints a setup token. Open StatsRaven in a browser, enter the token and create the admin account. The token works once. Get started then shows how to send data from a website, a log file, OpenTelemetry, Fluent Bit, Vector or Cloudflare Workers.

Without a license StatsRaven runs as Free: one project and seven days of data. A license file raises both. Upload it in Settings, License.

HTTPS

Browsers, the snippet on your sites and MCP clients should reach StatsRaven over HTTPS. Caddy gets and renews a certificate on its own. Point a domain at the server, then put this in /etc/caddy/Caddyfile:

stats.example.com {
	reverse_proxy 127.0.0.1:7600
}

Any other proxy works as long as it passes the Host header and, for HTTPS, X-Forwarded-Proto: https. On a home network StatsRaven also works over plain HTTP at an address such as http://192.168.1.20:7600.

Settings that come from the environment

VariableWhat it sets
STATSRAVEN_DATA_DIRWhere data is kept. ./data unless set; /data in Docker
STATSRAVEN_LISTENThe address of the web app, ingest, MCP and the SQL API. 127.0.0.1:7600; 0.0.0.0:7600 in Docker
STATSRAVEN_OTLP_GRPCThe address for OpenTelemetry over gRPC. 127.0.0.1:4317
ANTHROPIC_API_KEYA key for chat and pattern naming. It can also be set in Settings, AI, with any OpenAI-compatible service instead

For the service, put them in /etc/statsraven/statsraven.env and restart it. Every setting and command is listed in Storage, backup and updates.

Updates

Run the same install command again. It replaces the program and keeps the data, and with --service it restarts the service. In Docker, pull the new image and start the container again with the same volume. Every release is listed at statsraven.com/download.

Check a download

Each release has a SHA256SUMS file signed with minisign and an SBOM of what the program is made of. The installer always checks the checksum, and checks the signature too when minisign is installed. To check by hand:

sha256sum -c --ignore-missing SHA256SUMS
minisign -Vm SHA256SUMS -P RWQGD28Ob4OfqEDxDwLBtLW+HtT3ScpIsBR495bNpQ8peDpsKhRRS1MT

The public key is also at statsraven.com/minisign.pub.

Network

StatsRaven connects out only to the AI provider, sign-in providers, and the email server, Slack and webhook addresses you set for alerts. There is no telemetry, update check or license call, so it runs behind a firewall that allows nothing else.

Remove it

sudo systemctl disable --now statsraven
sudo rm /etc/systemd/system/statsraven.service /usr/local/bin/statsraven
sudo rm -r /var/lib/statsraven   # this deletes all stored data