TiloBox
Back to directory
Sentry Self-Hosted project preview

Sentry Self-Hosted

The official self-hosted edition of Sentry application error and performance monitoring.

LicenseFSL-1.1-MIT
GitHub stars9.5k
Last commit1 weeks ago
Tags6 topics
DebuggingError TrackingSelf HostedPythonCrash ReportingApm
Overview

Why consider Sentry Self-Hosted?

Sentry Self-Hosted is the official on-premises deployment of Sentry. It provides application error tracking, performance tracing, release health, and session tracking.

Guided learning

Learn Sentry Self-Hosted by building

Practical setup notes, real use cases, and copy-ready examples in one focused guide.

3 min read 10 sections
In this guide10 sections

What is Sentry Self-Hosted?

Sentry Self-Hosted is the official, open-source Docker Compose distribution of the Sentry application performance and error monitoring platform. Written in Python, Rust, and TypeScript with ClickHouse and PostgreSQL, Sentry operates as the industry-standard crash reporting and error tracking solution for development teams.

Sentry captures runtime exceptions, crash stack traces, performance transaction spans, and user feedback across more than 100 programming languages and frameworks (JavaScript, Python, Go, Java, Swift, Kotlin, Rust, PHP, .NET), demangling sourcemaps and deduplicating errors into actionable issues with release tracking.

Who Is It For?

  • Software Engineering Organizations: Capturing and triaging unhandled runtime exceptions and performance regressions across production services.
  • Enterprise Security & Compliance Teams: Enforcing complete data isolation by retaining sensitive error crash dumps and user telemetry within private VPCs.
  • DevOps Engineers: Integrating crash alerts with GitHub issue tracking, Slack channels, and automated rollback scripts.

Key Features

  • Multi-language error instrumentation: Official SDKs with automatic exception capturing, breadcrumb logging, and context enrichment.
  • Demangled stack traces: Full support for JavaScript sourcemaps, native symbolication (dSYM, ProGuard, breakpad), and source code previews.
  • Release health and regression tracking: Monitor crash-free session percentages and detect when new releases introduce regressions.
  • Distributed tracing and performance monitoring: Trace API requests from browser clients through backend microservices and databases.
  • Alerting and incident management: Configure alert rules with notifications to Slack, Discord, PagerDuty, and email.

Deploying Sentry Self-Hosted with Docker

bash
1# 1. Clone the official self-hosted repository
2git clone https://github.com/getsentry/self-hosted.git
3cd self-hosted
4
5# 2. Run the automated installation script
6./install.sh

Start Sentry:

bash
1docker compose up -d

Open http://localhost:9000 in your browser to access the Sentry web portal.

Practical Use Cases

1. Production Exception Triage

An unhandled exception occurs in a production Django backend; Sentry groups the 1,000 resulting error occurrences into a single issue, alerting engineers on Slack with exact variable values.

2. Client-Side JavaScript Crash Monitoring

A React single-page app encounters a rendering crash; Sentry captures the error alongside previous user breadcrumbs and demangled TypeScript stack traces.

3. Release Regression Detection

A team deploys version 2.4.0; Sentry detects that crash-free user sessions dropped from 99.9% to 92.1%, automatically creating a high-priority incident.

Troubleshooting and Limitations

  • System Memory Requirements: Sentry Self-Hosted is an enterprise stack involving Kafka, ClickHouse, Redis, Snuba, and PostgreSQL; allocate at least 8–16 GB of RAM on the host server.
  • Kafka Storage Cleanup: Sentry includes automated cleanup jobs; run docker compose run --rm web cleanup --days 30 via cron to prune historical event data.

Official Resources

Related tools

More options with a similar category or technology profile.

Sentry Self-Hosted FAQs

Sentry Self-Hosted is listed as a Developer Tools tool on TiloBox. Review the overview, features, and official documentation on this page to decide whether it solves your specific workflow.

Start with the project's GitHub repository and official website for supported installation and deployment instructions. Test the setup with representative data or a small project before rolling it out more widely.

Sentry Self-Hosted is listed under the FSL-1.1-MIT license. Read the complete license text and the project's notices before using, modifying, or distributing the software.

Production readiness depends on your requirements. Review maintenance activity, security practices, documentation, backup and upgrade procedures, and compatibility with your stack; then validate it in a non-production environment.

Sentry Self-Hosted is listed as an alternative to Bugsnag. Compare the core workflow, deployment model, integrations, and licensing against your must-have requirements before switching.