Skip to main content
Sentry can be deployed on your own servers instead of using the managed cloud service at sentry.io. The self-hosted distribution is the same codebase as the cloud product and is distributed as a Docker Compose application.

​
When to self-host

Self-hosting is a good fit when you:
  • Must keep event data within your own network or a specific region
  • Have compliance requirements that prevent sending data to a third-party SaaS
  • Want to customize Sentry’s configuration or run it behind an internal firewall
The managed cloud service at sentry.io has a free tier and requires no infrastructure to maintain. If you don’t have a specific reason to self-host, the cloud service is the faster way to get started.

​
How it works

The self-hosted distribution uses Docker Compose to orchestrate all of Sentry’s required services:
  • Sentry web — the Django application and API server
  • Sentry worker — Celery background task workers
  • Sentry cron — scheduled task processor
  • PostgreSQL — primary relational database
  • Redis — caching, rate limiting, and queuing
  • ClickHouse (via Snuba) — event storage and querying
  • Relay — event ingestion and filtering proxy
  • Symbolicator — debug symbol processing for native and mobile crashes
All services are configured through a sentry.conf.py file and environment variables. The configuration file extends Sentry’s defaults and supports overriding any Django setting. 
# sentry.conf.py example — configure your database and Redis connections
from sentry.conf.server import *
import os

env = os.environ.get

DATABASES = {
    "default": {
        "ENGINE": "sentry.db.postgres",
        "NAME": env("SENTRY_DB_NAME") or "sentry",
        "USER": env("SENTRY_DB_USER") or "sentry",
        "PASSWORD": env("SENTRY_DB_PASSWORD") or "",
        "HOST": env("SENTRY_POSTGRES_HOST") or "postgres",
        "PORT": env("SENTRY_POSTGRES_PORT") or "",
    }
}

SENTRY_CACHE = "sentry.cache.redis.RedisCache"

​
Single-organization mode

Self-hosted installations default to single-organization mode: 
# sentry.conf.py
SENTRY_SINGLE_ORGANIZATION = True
In this mode, the UI hides organization-switching controls and assumes all users belong to one organization. Set this to False if you want to host multiple organizations on a single instance.

​
Full installation guide

For complete installation instructions, including system requirements, initial setup commands, upgrade procedures, and backup guidance, see the Self-hosted tab in the sidebar.
The official self-hosted repository at github.com/getsentry/self-hosted contains the Docker Compose files, an automated install script, and release changelogs.

Build docs developers (and LLMs) love

Get started for freeTalk to us