Incidental logo

Incidental

Centralized Slack‑enabled platform for streamlined incident response

Incidental provides a unified hub to declare, track, and resolve incidents via Slack and a web UI, supporting custom severities, fields, types, roles, and public status pages.

Incidental banner

Overview

Overview

Incidental is a self‑hosted incident management platform that brings incident declaration, coordination, and resolution into a single workspace. Teams work directly from Slack using ChatOps commands, while a clean web UI offers deeper investigation, custom severity levels, flexible fields, incident types, and role assignments. Public status pages keep stakeholders informed in real time, and the system is built to adapt to each organization’s operational model.

Deployment

The stack runs on Docker‑Compose with a Python backend and a React frontend. After creating a Slack app and configuring environment variables, developers can start the backend on http://localhost:5000 and the frontend on http://localhost:3000 with simple make run-dev commands. A hosted version is also available at incidental.dev for teams that prefer a managed service. While the core features are stable, custom workflow automation is slated for a future release, and the project welcomes community contributions to accelerate its roadmap.

Highlights

ChatOps integration for incident handling directly in Slack
Intuitive web UI for detailed incident management
Fully customizable severities, fields, types, and roles
Public status pages for transparent stakeholder communication

Pros

  • Tight Slack integration speeds up on‑call response
  • Highly customizable to match organizational processes
  • Open‑source MIT license encourages community contributions
  • Simple Docker‑Compose setup for local development

Considerations

  • Early‑stage project may contain bugs or missing polish
  • Advanced workflow automation is not yet available
  • Requires manual Slack app configuration and environment setup
  • Self‑hosting demands Docker, Node, and Python runtime knowledge

Managed products teams compare with

When teams consider Incidental, these hosted platforms usually appear on the same shortlist.

Atlassian Opsgenie logo

Atlassian Opsgenie

Service-aware alerting, on-call, and incident orchestration.

AWS Systems Manager Incident Manager logo

AWS Systems Manager Incident Manager

On-call, escalation, runbooks, and chat for AWS incidents.

FireHydrant Incident Management logo

FireHydrant Incident Management

Runbooks, on-call, Slack-native collaboration, and postmortems.

Looking for a hosted option? These are the services engineering teams benchmark against before choosing open source.

Fit guide

Great for

  • Teams already using Slack for communication
  • Organizations needing custom incident data fields
  • Companies that want a self‑hosted, extensible solution
  • Groups looking to publish real‑time status pages

Not ideal when

  • Teams without Slack or preferring other chat platforms
  • Enterprises requiring out‑of‑the‑box advanced automation
  • Users seeking a fully mature, enterprise‑supported product
  • Organizations lacking Docker/Node expertise for self‑hosting

How teams use it

On‑call alert handling via Slack

Incidents are declared and triaged instantly within the Slack workspace, reducing mean time to acknowledge.

Public incident communication

Stakeholders access a customizable status page that reflects real‑time incident progress and resolution.

Compliance‑driven incident tracking

Custom fields capture required regulatory data, ensuring audits have complete incident records.

Post‑mortem analysis workflow

Structured incident data feeds into retrospective reports, helping teams identify root causes and improve processes.

Tech snapshot

Python52%
TypeScript46%
CSS1%
Dockerfile1%
JavaScript1%
Mako1%

Tags

open-sourcepython3incident-responseincidentreactincident-management

Frequently asked questions

How do I get started with Incidental?

Clone the repository, create a Slack app using the provided manifest, set the environment variables, and run `make run-dev` for both backend and frontend.

What technologies power Incidental?

The backend is written in Python, the frontend uses React/TypeScript, and Docker Compose orchestrates the services.

Can I define my own severity levels?

Absolutely—severity levels are fully configurable through the web UI or API.

How can I contribute to the project?

Fork the repo, create a feature branch, commit your changes, and open a pull request. See the CONTRIBUTING section for details.

Project at a glance

Dormant
Stars
557
Watchers
557
Forks
22
LicenseMIT
Repo age1 year old
Last commitlast year
Primary languagePython

Last synced yesterday