Sentry Self-Hosted
The official self-hosted edition of Sentry application error and performance monitoring.
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.
Learn Sentry Self-Hosted by building
Practical setup notes, real use cases, and copy-ready examples in one focused guide.
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
# 1. Clone the official self-hosted repositorygit clone https://github.com/getsentry/self-hosted.gitcd self-hosted# 2. Run the automated installation script./install.shStart Sentry:
docker compose up -dOpen 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 30via cron to prune historical event data.
Official Resources
- Official Website: https://sentry.io
- GitHub Repository: https://github.com/getsentry/self-hosted
- Documentation: https://develop.sentry.dev/self-hosted/
Related tools
More options with a similar category or technology profile.
diskus
Minimal, fast alternative to du -sh written in Rust using multi-threaded directory traversal.
peco
Simplistic interactive filtering tool for Unix pipelines, process lists, and file trees.
Dapr CLI
Command-line tool for managing Dapr distributed application runtime environments and sidecars.
Freeze
Generate beautiful image screenshots and SVGs of code snippets and terminal outputs.