# Firewatch documentation

> Use, administer, integrate, and operate Firewatch on-call alerting.

This is the machine-readable version of this Firewatch documentation page.

<div class="docs-index-intro">
  <p>
    Learn how Firewatch routes alerts, manages on-call coverage, escalates
    missed pages, and keeps responders informed.
  </p>
  <div class="docs-index-actions">
    <LinkButton
      href="/docs/getting-started/"
      variant="primary"
      icon="right-arrow"
    >
      Start reading
    </LinkButton>
    <LinkButton href="/docs/integrations/" variant="minimal" icon="puzzle">
      Browse integrations
    </LinkButton>
  </div>
</div>

## Machine-readable documentation

Agents and tooling can use the documentation files generated from this same
source. Start with the concise index, then choose the abridged or complete
content set for the context window you have available.

- [Documentation index](/llms.txt)
- [Abridged documentation](/llms-small.txt)
- [Complete documentation](/llms-full.txt)

## Choose a guide

<CardGrid class="docs-index-grid">
  <Card title="Get started" icon="rocket">
    Configure your profile, service, schedule, escalation policy, and first
    alert. [Follow the setup path](/docs/getting-started/).
  </Card>
  <Card title="Understand alert routing" icon="setting">
    Learn how services, schedules, escalation policies, and notification
    channels determine who is contacted. [Read the alert
    lifecycle](/docs/concepts/alert-lifecycle/).
  </Card>
  <Card title="Connect integrations" icon="puzzle">
    Configure alert sources and outbound email, Slack, SMS, voice, and webhook
    delivery. [Review integrations](/docs/integrations/).
  </Card>
  <Card title="Build with the API" icon="document">
    Discover the versioned REST API and its generated OpenAPI contract. [Open
    the API guide](/docs/api/).
  </Card>
  <Card title="Operate a self-hosted installation" icon="server">
    Install the complete product with Docker Compose and configure the services
    you operate. [Open the self-hosting guide](/docs/self-hosting/).
  </Card>
</CardGrid>

## Set up your on-call workflow

1. **Understand the alert lifecycle** from ingestion through acknowledgement,
   escalation, and resolution.
2. **Create a service, schedule, and escalation policy** that reflect your
   actual responder coverage.
3. **Connect an alert source** and configure the delivery channels you operate.
4. **Send a test alert** and verify acknowledgement, escalation, and recovery
   before relying on the system for production paging.

Before relying on any paging system in production, validate alert delivery,
escalation, backup, and recovery behavior against your organization’s
availability, security, and compliance requirements.