CLI

The crashcart binary is both the server and the admin tool. Every subcommand reads DATABASE_URL and the other environment variables; most connect to the database and exit.

crashcart serve                              HTTP server + job worker + schedulers (default)
crashcart migrate                            apply pending migrations and exit
crashcart retention                          reconcile policies and run one sweep
crashcart alerts                             run one crash-spike check
crashcart seed [slug]                        write a week of demo data (default project "demo")
crashcart export [slug]                      stream NDJSON to stdout (all projects, or one)
crashcart import                             load NDJSON from stdin (idempotent)
crashcart project <slug> <name> [platform]   create a project and print its DSN
crashcart rotate-key <slug>                  replace the project's DSN key and print the new DSN

With Docker Compose, prefix with docker compose exec crashcart /crashcart.

serve

Runs everything in one process: HTTP on LISTEN_ADDR, WORKERS job goroutines, the retention scheduler and the crash-spike scheduler (ALERT_INTERVAL). Migrations run first. This is the default when no subcommand is given.

migrate

Applies pending migrations and exits. Useful in a deploy pipeline step, or to prepare a database before import. Chooses the TimescaleDB or plain variant on first run according to TIMESCALE.

retention

Reconciles the compression and retention policies with the current COMPRESS_AFTER / RETENTION_DAYS, runs one retention sweep, and on plain Postgres rolls up the hourly statistics. Exits when done — for cron.

alerts

Evaluates the crash-spike rule once for every project and queues alerts. Exits when done — for cron.

seed [slug]

Writes a week of realistic demo data (issues, events, sessions across a few releases) into the project slug, creating it if needed. Default demo.

export [slug]

Writes everything to stdout as NDJSON in the export format: all projects, or just slug. Per-table row counts go to stderr.

crashcart export > backup.ndjson
crashcart export shop-ios | gzip > shop-ios.ndjson.gz

import

Reads NDJSON from stdin and upserts. Safe to run twice or against a live database; unknown project slugs are created; lines with an unknown "t" are counted as skipped. Counts go to stderr.

crashcart import < backup.ndjson

project <slug> <name> [platform]

Creates a project and prints its id and DSN (using PUBLIC_URL when set). platform, if given, must be one of the SDK families: ios, android, flutter, react-native, web, backend, other.

rotate-key <slug>

Generates a new DSN key. The old one is rejected immediately.

Exit status

0 on success. Any error is logged and exits 1.