# Terminal Duty documentation

The [README](../README.md) is the short tour. These pages hold the detail.

**Running it**
- [Deployment](./deployment.md): Docker, the Helm chart, the database, backups, and the operator.
- [Configuration](./configuration.md): environment variables and settings.
- [Single sign-on](./single-sign-on.md): OIDC, group mapping, the terminal device flow.

**Using it**
- [The web UI](./web-ui.md): sessions, the Team and Admin tabs.
- [Alertmanager configuration](./alertmanager.md): routes, integration keys and webhooks.
- [Alerts and incidents](./incidents.md): correlation, lifecycle, on-call assignment, stale-alert expiry.
- [Push notifications](./notifications.md): ntfy pages and acknowledging from them.
- [Escalation](./escalation.md): ladders, repeats and the fallback topic.
- [Dead man's switches](./dead-mans-switch.md): noticing that alerts stopped arriving.

**Integrating and contributing**
- [API reference](./api.md): every endpoint, authentication and error shape.
- [Service accounts](../SERVICE-ACCOUNTS.md): non-human credentials for automation.
- [Development and releasing](./development.md): tests, the CI gate, the release pipeline.