Back to all templates
Bugsink logo

Bugsink

Development512MB+ RAM

Self-hosted, Sentry-compatible error tracking (single container, SQLite)

developmentdevtoolsbugsinkopen-sourceself-hosteddocker

Deploy Bugsink in 3 Steps

1

Connect Your VPS

Add your server credentials to Server Compass

2

Select Bugsink

Choose from our template library

3

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required
Step-by-step deployment guide

Deploy Bugsink on a VPS with Server Compass

Use the Bugsink template in Server Compass to deploy a self-hosted Sentry-compatible error tracking app on your VPS, then verify the web UI.

About 10 minutesBrowser verified
1
Step 1

Open the server Apps tab

Select the tutorial-vps VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.

Server Compass Apps tab before creating a Bugsink app
2
Step 2

Choose an app template

Click New App and choose the template deployment path so Server Compass can load the built-in catalog.

Choosing to deploy an app from a Server Compass template
3
Step 3

Search for Bugsink

Use the template picker search to find Bugsink in the Server Compass template catalog.

Searching for Bugsink in the Server Compass template picker
4
Step 4

Select the Bugsink template

Choose the Bugsink template. Server Compass fills the Bugsink service, SQLite data volume, generated secret key, initial admin email and password, base URL, and public web port.

Bugsink template selected in Server Compass
5
Step 5

Review the Bugsink settings

Confirm the app name and compose service. In this run, the app was named bugsink-demo and used host port 4069.

Reviewing Bugsink project settings and compose service
6
Step 6

Deploy Bugsink

Review the generated compose settings, confirm the Bugsink web port is available, and click Deploy.

Reviewing Bugsink web port before deployment
7
Step 7

Watch the deployment progress

Keep the deployment modal open while Server Compass uploads the compose file, pulls the Bugsink image, starts the container, and verifies the stack.

Server Compass deploying the Bugsink template on the VPS
8
Step 8

Confirm Bugsink is running

After deployment finishes, return to the Apps tab and confirm the Bugsink app is marked Running with its application URL available.

Bugsink template running in the Server Compass Apps tab
9
Step 9

Open Bugsink in the browser

Open the application URL in a browser. The Bugsink login or project screen confirms the error tracking web UI is reachable.

The deployed Bugsink web UI loaded in a browser

After Bugsink Opens

  • Place Bugsink behind HTTPS before sending production error events.
  • Create the first admin account intentionally and restrict registration after setup.
  • Update EXTERNAL_URL to the real public URL before using embeds, OAuth callbacks, or production bots.
  • Protect LLM/API provider keys used by bots and rotate test keys before production.
  • Back up the Bugsink data volume because it stores the SQLite database, projects, events, and configuration.
  • Review conversation logs for PII handling before inviting real users.
  • Keep the Bugsink image updated for dependency and security fixes.

Verified Result

The Bugsink web interface loaded successfully from the deployed container.

Bugsink deployment questions

What does the Bugsink template deploy?

It deploys the Bugsink web app as a single container with a persistent SQLite data volume.

Which port did the tutorial use?

The tutorial used host port 4069, which maps to the Bugsink web UI on container port 8000.

Does Bugsink need setup after deployment?

Yes. Create the first admin account, configure the public URL, then add bot integrations and provider keys.

Should this become a blog post?

No. The deployment guide should live on the Bugsink template detail page and be linked from the reusable template deployment docs page.

After Deployment

After deploying Bugsink with Server Compass, complete these steps to finish setup

1

Visit the application URL

2

Log in as admin with ADMIN_PASSWORD

3

Create a project and copy the DSN

4

Configure your Sentry SDK in your application with the DSN

Need help? Check out our documentation for detailed guides.

Bugsink FAQ

Common questions about self-hosting Bugsink

How do I deploy Bugsink with Server Compass?

Simply download Server Compass, connect to your VPS, and select Bugsink from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.

What are the system requirements for Bugsink?

Bugsink requires a minimum of 512MB RAM. We recommend a VPS with at least 1024MB RAM for optimal performance. Any modern Linux server with Docker support will work.

Can I migrate my existing Bugsink data?

Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard Bugsink backup and restore procedures.

How do I update Bugsink to the latest version?

Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest Bugsink image will be pulled and deployed with zero downtime.

Is Bugsink free to self-host?

Bugsink is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.

Ready to Self-Host Bugsink?

Download Server Compass and deploy Bugsink to your VPS in under 3 minutes. No Docker expertise required.

Download Server Compass