# Dead-Man Switch Monitoring

When a self-hosted on-call server experiences catastrophic failure, network disconnection, or host power loss, it cannot send alerts about itself. OnCallAlert solves this failure mode with an automated out-of-band **Dead-man Switch**.

## How It Works

1. Your self-hosted OnCallAlert instance sends an encrypted heartbeat ping to the OnCallAlert SaaS monitor at configured intervals.
2. If consecutive heartbeats fail to arrive within the threshold period, our external monitoring service detects the silence.
3. The monitor dispatches an immediate high-priority push notification directly to the mobile phones of your administrators, alerting them to the silent outage.
4. When heartbeats resume, an all-clear resolution notice is sent.

## Configuration

Configure the dead-man switch in the web UI under **Admin &rarr; Config &rarr; Deadman**:

1. **Enable**: Toggle to active.
2. **Interval seconds**: Heartbeat frequency between 300 and 3600 seconds (5 minutes to 1 hour; default: 300).
3. **Miss count**: Number of consecutive missed intervals before alerting (1 to 10; default: 3). With 300s and 3 misses, silence alerts fire after 15 minutes.
4. **Recipients**: Responders assigned to the auto-generated **SaaS heartbeat** service's escalation policy receive the push alerts.
