Bugsink documentation

Bugsink is an error tracker for your applications. It is compatible with the Sentry SDKs and puts errors, stacktraces, and debugging information first.

Why Bugsink?

An overview of what Bugsink is and why you might want to use it:

• What is Error Tracking?
• Built to self-host
• Sentry-SDK Compatible
• Scalable and Reliable

Getting started

First, set up a running Bugsink instance. You can either let us manage it for you and skip the infrastructure work, or self-host it for full control:

• Managed by Bugsink: start with a free account or a free trial.
• Self-hosted: start with the installation guide.

Both paths continue with the Quickstart: create a project, connect an application, and track your first error.

Usage

Once you have a running Bugsink instance, you’ll want to set up your projects, teams, and more:

• Projects (the apps you’re tracking)
• Teams (projects are organized into teams)
• Releases (track your apps releases)
• Alerts (get notified when errors happen)
• Grouping (group similar errors together)
• Permissions (who can do what)
• SDK configuration recommendations
• Sourcemaps (unminify JavaScript stacktraces)
• Ingestion rate-limits and retention policies
• API API reference for Bugsink’s REST API

Alert integrations

• Slack
• Mattermost
• Discord
• Microsoft Teams
• Telegram
• Custom webhooks

Self-host

Run Bugsink on your own infrastructure. Start with the installation overview, or go directly to one of the installation guides:

• Docker installation
• Docker Compose
• Local installation using Virtualenv
• Single Server Production Setup

Configuration and operations:

• Settings overview
• Proxy headers (for when you’re behind a reverse proxy)
• Upgrading (keeping your Bugsink instance up-to-date)
• MySQL
• PostgreSQL

Troubleshooting

Here’s a short list of ways to troubleshoot common issues:

• Dogfooding (using Bugsink to track Bugsink errors)
• CSRF configuration issues
• Event-ingestion/digestion troubleshooting