---
title: "Deploy Bugsink"
description: "Bugsink 2.6 self-hosted error tracking that works with Sentry SDKs."
category: "Observability"
url: https://railway.com/deploy/bugsink-1
---

# Deploy Bugsink

Bugsink 2.6 self-hosted error tracking that works with Sentry SDKs.

**[Deploy Bugsink on Railway](https://railway.com/template/bugsink-1)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/bugsink-1/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** Observability

## Template content

### bugsink https://raw.githubusercontent.com/bugsink/bugsink/2.6.0/static/favicon.png

- **Image:** bugsink/bugsink:2.6.0
- **Start command:** `sh -c 'exec monofy bugsink-show-version "&&" bugsink-manage check --deploy --fail-level WARNING "&&" bugsink-manage migrate snappea --database=snappea "&&" bugsink-manage migrate "&&" bugsink-manage prestart "&&" gunicorn --config gunicorn.docker.conf.py "--bind=[::]:$PORT" --access-logfile - bugsink.wsgi "|||" bugsink-runsnappea'`
- **Health check:** /health/ready
- **Public domain:** Yes

## Documentation

# Deploy and Host Bugsink on Railway

Bugsink is a self-hosted error tracker that is compatible with the Sentry SDKs. Applications in Python, JavaScript, Go, Ruby, PHP, Java and more report exceptions to a DSN, and Bugsink groups them into issues with stack traces, breadcrumbs, tags and email alerts, without the operational weight of self-hosted Sentry.

## About Hosting Bugsink

This template deploys Bugsink v2.6.0 from the official image as a single service with SQLite on a Railway volume. The admin account is created from environment variables on first start, and phone-home is off. The server listens on IPv4 and IPv6, so applications on Railway can report over the private network or through the public domain. Host checks cover your Railway domain and Railway's health check. Bugsink is light and fits the Hobby plan; the volume grows with stored events. Point any Sentry SDK at the DSN of a project you create in the web UI.

## Common Use Cases

- Error tracking for web apps, APIs and workers with existing Sentry SDKs
- A self-hosted Sentry alternative when data must stay on your infrastructure
- Catching exceptions in staging and preview environments

## Dependencies for Bugsink Hosting

- `bugsink/bugsink:2.6.0` (official image)
- A Railway volume at `/data` for the SQLite database

### Deployment Dependencies

- [Bugsink documentation](https://www.bugsink.com/docs/)
- [Bugsink settings](https://www.bugsink.com/docs/settings/)
- [Bugsink on GitHub](https://github.com/bugsink/bugsink)
- [Railway volumes](https://docs.railway.com/reference/volumes)

### Implementation Details

| Service | Image | Networking | Storage |
| --- | --- | --- | --- |
| bugsink | `bugsink/bugsink:2.6.0` | public domain on 8000; private IPv4/IPv6 | volume at `/data` |

Create a team and project in the web UI, then use its DSN:

```python
import sentry_sdk
sentry_sdk.init(dsn="https://@/1")
```

| Variable | Default | Purpose |
| --- | --- | --- |
| `BUGSINK_ADMIN_EMAIL` / `BUGSINK_ADMIN_PASSWORD` | `admin@example.com` / generated | First admin, created via `CREATE_SUPERUSER` |
| `SECRET_KEY` | generated | Django secret |
| `ALLOWED_HOSTS` | domain, private domain, health-check host | Host allow list |
| `PHONEHOME` | `false` | Anonymous usage reporting |

Notes:

- The start command is the image's own command with Gunicorn bound to `[::]`, so the private network works; keep it when editing the service.
- Set `EMAIL_HOST` and related variables to enable alert emails.

This is a community-maintained deployment package and does not imply affiliation with or endorsement by the Bugsink project or its maintainers.

## 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.


## Similar templates

- [Rootprint](https://railway.com/deploy/rootprint-1) — Open-source logs and traces with full-text search on object-storage.
- [Pyroscope profiling](https://railway.com/deploy/pyroscope-profiling) — Protected continuous profiling with durable Pyroscope storage.
- [SigOnly](https://railway.com/deploy/sigonly) — Deploy SigNoz with a working demo app & config in one click

Open this page in a browser: https://railway.com/deploy/bugsink-1