selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

IncidentRelay logo

Self-host IncidentRelay

v2.4.0

Self-hosted on-call scheduling and incident response

ReleaseSource AvailableOther
Updated12 hours ago
LanguagePython
Setup difficultyModerate
MobilePWA
Stars
223
Port
8080 (HTTP API, UI and incoming webhooks)
Docker
ghcr.io/roxy-wi/incidentrelay
Install with Docker Compose
Alert inbox with status, severity, team, assignee and escalation filtersMonthly on-call calendar showing scheduled shifts and respondersOn-call rotations interface with members and schedule configurationAlert routes connecting sources, teams, rotations and notification channelsExplain Trace showing alert routing, grouping and notification decisionsHeartbeats page showing dead-man-switch checks and tracked producer stateGlobal orchestration page showing shared ordered event processing rulesGlobal rule editor with nested conditions and actionsEvent orchestration page with service-specific ordered rulesOrchestration execution history showing matched rules and resulting event payload

What is IncidentRelay?

IncidentRelay is a self-hosted platform for on-call management and incident response, built for SRE and DevOps teams. It ingests alerts from monitoring tools such as Prometheus Alertmanager, Grafana, Datadog, Zabbix, and AWS CloudWatch, then normalizes, routes, and groups them into incidents. The system provides on-call scheduling with rotations, overrides, and escalation policies, plus notification delivery through multiple chat platforms, email, and voice calls. It supports OIDC and SAML 2.0 single sign-on, browser and PWA push notifications, and an Event Orchestration engine for transforming and routing alerts before they reach responders. Deployment options include Docker Compose, Helm/Kubernetes, RPM packages, or manual systemd installation, with SQLite for small setups or PostgreSQL for larger ones. The project uses the Elastic License 2.0 (source-available), allowing self-hosted and internal use while requiring a commercial license for hosted-service offerings.

Should you self-host IncidentRelay?

IncidentRelay scores 47/100 on selfhost.directory (how scoring works) and ranks #31 of 51 in Monitoring & observability. It has 223 GitHub stars.

It shipped 9 stable releases in the past year. The latest, v2.4.0, came out on 25 October 2026. New versions land roughly every 2 weeks.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Other-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is ITOps Agent Platform (51/100, 946 stars). It scores higher overall, so compare the two before you pick. See IncidentRelay vs ITOps Agent Platform side by side.

Features

  • Alert intake and routing
  • Data retention policies
  • Event Orchestration
  • Explain Trace
  • Incident Management
  • Migration Tools
  • Notification delivery
  • OIDC and SAML 2.0 SSO
  • On-call scheduling and rotations
  • Prometheus Metrics
  • REST API with OpenAPI documentation
  • Service catalog and impact

IncidentRelay README

How to install IncidentRelay

Install IncidentRelay with Docker Compose

Docker and Docker Compose
Environment variables
INCIDENTRELAY_CONFIG_FILE, INCIDENTRELAY_SERVICE, INCIDENTRELAY_RUN_MIGRATIONS, INCIDENTRELAY_PORT, INCIDENTRELAY_WEB_WORKERS, INCIDENTRELAY_WEB_THREADS, INCIDENTRELAY_WEB_TIMEOUT

cd docker docker compose up -d

Open: http://SERVER_IP:8080/login

Use PostgreSQL with the supplied override: docker compose
-f docker-compose.yml
-f docker-compose.postgres.yml
up -d

Fastest way to run a small self-hosted installation. Uses published IncidentRelay image and starts web service, scheduler, Telegram worker and Slack Socket Mode worker.

IncidentRelay releases & version history

FAQ

Which alert sources are supported?

Supported alert sources include Cloud.ru Cloud Eye / SMN, New Relic, Nagios, Azure Monitor, AWS SNS and CloudWatch, Grafana Alerting, Prometheus Alertmanager, Datadog, Uptime Kuma, Zabbix, Sentry, LibreNMS and RMON. Generic webhooks, PagerDuty Events API v2 compatibility and heartbeats cover custom integrations and missing-signal monitoring.

Is it similar to Grafana OnCall?

IncidentRelay focuses on similar operational workflows: rotations, alert routing, escalation, acknowledgements, resolve actions, silences and monitoring integrations.

Is it a PagerDuty alternative?

IncidentRelay can be used by teams looking for a self-hosted, open-source approach to on-call scheduling, alert routing, escalation policies and incident response workflows.

What is IncidentRelay?

IncidentRelay is open-source on-call management and incident response software for routing alerts, notifying responders, managing rotations and reducing alert noise.

More in Monitoring & observability

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…