Deploy and Host Bugsink on Railway

Built for an LLM agent to deploy and use. There is no setup wizard and nothing to fill in: the admin password, the project DSN key and a full-access API token are generated at deploy time and are valid from the first boot. The contract below lists every URL, variable name and the one script that proves it works.

Bugsink is a self-hosted error tracker that speaks the Sentry protocol. Point any Sentry SDK at its DSN and it groups exceptions into issues, with stack traces, breadcrumbs and a REST API to read them back. It is a small, single-container alternative to a full Sentry install.

About Hosting Bugsink

This template runs one service: the official Bugsink 2.6.2 image (bugsink/bugsink, pinned by digest). Events are stored in SQLite on a volume at /data, so the server needs no separate database. A boot wrapper prepares the root-owned Railway volume, creates the admin user, a project named Default (project id 1) and the API token from the service variables, then starts the stock web server and background worker. The same values apply after every redeploy, and phone-home telemetry is off. Allow about a minute for the first deploy to turn healthy.

Agent contract

Public URL: BASE_URL, which is https:// plus the RAILWAY_PUBLIC_DOMAIN of the bugsink service. It serves the web UI at /, event ingest under /api/1/ and the REST API under /api/canonical/0/.
Private URL: http://bugsink.railway.internal:8080
Credentials: web UI login is BUGSINK_ADMIN_EMAIL with the password in BUGSINK_ADMIN_PASSWORD; the project DSN key is BUGSINK_PROJECT_KEY; the REST API token is BUGSINK_API_TOKEN.
Auth: ingest sends the DSN key in the X-Sentry-Auth header (sentry_key=BUGSINK_PROJECT_KEY). The DSN for any Sentry SDK is https://BUGSINK_PROJECT_KEY@/1. The REST API takes Authorization: Bearer BUGSINK_API_TOKEN.
Health: GET /health/ready returns 200 with no credentials

# run with BASE_URL, BUGSINK_PROJECT_KEY and BUGSINK_API_TOKEN set; needs curl
curl -s -o /dev/null -w 'health %{http_code}\n' "$BASE_URL/health/ready"
curl -s -o /dev/null -w 'anonymous %{http_code}\n' "$BASE_URL/api/canonical/0/projects/"
curl -fsS -X POST "$BASE_URL/api/1/store/" \
  -H "X-Sentry-Auth: Sentry sentry_version=7, sentry_key=$BUGSINK_PROJECT_KEY, sentry_client=curl/1.0" \
  -H 'Content-Type: application/json' \
  -d '{"message":"agent contract test","level":"error","platform":"other"}' -o /dev/null -w 'send event %{http_code}\n'
sleep 5
curl -fsS -H "Authorization: Bearer $BUGSINK_API_TOKEN" "$BASE_URL/api/canonical/0/issues/?project=1" | grep -o '"calculated_value":"agent contract test"'

A fresh deploy prints health 200, anonymous 401, send event 200 and "calculated_value":"agent contract test". Point any Sentry SDK at the DSN above, or open BASE_URL and sign in with the admin email and password.

Why Deploy Bugsink on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Bugsink on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.

Agent-ready - generated admin password, DSN key and API token that work on first boot, a contract block and one working script; no setup step.
Stable credentials - the password, DSN and token are the same after every redeploy.
State survives redeploys - issues and events live in SQLite on a volume at /data.
Single container - no Postgres, Redis or Kafka to run.
Pinned image - the image is pinned by digest, so a redeploy never changes the server version underneath you.

Common Use Cases

Self-hosted Sentry alternative - collect exceptions from web apps, workers and scripts with the standard Sentry SDKs.
Error tracking for side projects and small teams - a lightweight server that runs on a small Railway plan.
Agent-driven debugging - let an AI agent read new issues and events through the REST API and open fixes.

Dependencies for Bugsink Hosting

A volume at /data for the SQLite database (included in this template).

Deployment Dependencies

bugsink/bugsink - upstream project
Bugsink documentation - SDK setup and API reference