Self-Hosting Sentro
Run the full Sentro monitoring platform on your own infrastructure. Same powerful monitoring engine, complete data ownership, zero vendor lock-in.
What's Included
The self-hosted edition includes the full monitoring stack:
| Component | Description |
|---|---|
| Dashboard | Next.js web app for managing monitors, viewing incidents, and team collaboration |
| Admin Panel | System administration interface for managing users, orgs, and subscriptions |
| REST API | Fastify-based API for programmatic access and integrations |
| Monitor Worker | BullMQ background engine that runs HTTP checks, manages incidents, and dispatches alerts |
| PostgreSQL 16 | Primary database for all application data |
| Redis 7 | Job queue (BullMQ) and rate limiting |
Deployment Options
Choose the deployment method that fits your scale:
Docker Compose
Best for: Indie developers, small teams, staging environments
Single-machine deployment with everything bundled. Get running in under 5 minutes.
curl -fsSL https://sentro.dev/install.sh | bash
Kubernetes (Helm)
Best for: Production workloads, enterprises, teams that need HA
Full Helm chart with autoscaling, pod disruption budgets, Prometheus ServiceMonitor, and Ingress support. PostgreSQL and Redis are included, or point the chart at your managed instances.
git clone https://github.com/sentro-dev/self-hosted.git
helm install sentro ./self-hosted/helm/sentro -f my-values.yaml
System Requirements
Minimum (Docker Compose)
| Resource | Minimum | Recommended |
|---|---|---|
| CPU | 2 cores | 4 cores |
| Architecture | x86-64 (amd64) | x86-64 (amd64) |
| RAM | 4 GB | 8 GB |
| Disk | 20 GB | 50 GB SSD |
| OS | Any Docker-compatible | Linux (Ubuntu 22.04+, Debian 12+) |
Sentro images are published for x86-64 only. ARM machines — AWS Graviton, Ampere, Raspberry Pi, Apple Silicon — cannot run them natively and the install will stop with a "no matching manifest" error. Use an x86-64 host.
Minimum (Kubernetes)
| Resource | Minimum | Recommended |
|---|---|---|
| Nodes | 1 (single-node cluster) | 3+ nodes |
| CPU per node | 2 cores | 4 cores |
| RAM per node | 4 GB | 8 GB |
| Kubernetes | 1.26+ | 1.28+ |
| Helm | 3.12+ | 3.14+ |
Feature Comparison
| Feature | Cloud (SaaS) | Self-Hosted |
|---|---|---|
| HTTP monitoring | Yes | Yes |
| Multi-channel alerts | Yes | Yes |
| Team collaboration | Yes | Yes |
| Incident management | Yes | Yes |
| REST API | All plans | Team edition and above |
| Admin panel | N/A | Yes |
| AI assistant | Pro+ plan | Yes (bring your own key) |
| OIDC single sign-on | Yes | Business edition and above |
| Data retention | Plan-dependent | Up to 730 days, on your storage |
| Automatic updates | Yes | Manual (see Upgrading) |
| Managed infrastructure | Yes | You manage |
| Data sovereignty | US/EU regions | Your choice |
Architecture
┌─────────────────────────────────────────────────────┐
│ Load Balancer │
│ (nginx / Ingress / ALB) │
└──────┬──────────────┬──────────────┬────────────────┘
│ │ │
┌────▼────┐ ┌─────▼─────┐ ┌────▼────┐
│Dashboard│ │Admin Panel│ │REST API │
│ :3001 │ │ :3002 │ │ :4000 │
└────┬────┘ └─────┬─────┘ └────┬────┘
│ │ │
└──────┬───────┴──────┬───────┘
│ │
┌────────▼────────┐ ┌───▼───────────┐
│ PostgreSQL 16 │ │ Redis 7 │
│ :5432 │ │ :6379 │
└────────▲────────┘ └───▲───────────┘
│ │
┌─────┴──────────────┴─────┐
│ Monitor Worker │
│ (BullMQ check engine) │
│ Prometheus metrics:9464 │
└──────────────────────────┘
Next Steps
- Docker Compose Quickstart — Get running in 5 minutes
- Kubernetes Deployment — Production-grade Helm deployment
- Configuration Reference — All environment variables
- Licensing — License key editions, generation, and management
- Upgrading — How to update to new versions