# User Roles & Permissions

OnCallAlert provides clear role separation to protect infrastructure and audit access while keeping costs transparent.

## Roles Matrix

| Role | Responsibilities & Capabilities | Seat Consumption |
|---|---|---|
| **Owner** | Full administrative rights, including managing other Owners and Admins, server activation, license key renewal, and system-level configuration. | Uses a paid seat |
| **Admin** | Manages services, escalation policies, rotations, schedules, user invitations, and general system settings. | Uses a paid seat |
| **On-call** | Active responder. Participates in rotations, appears on escalation policy steps, receives pages, acknowledges, and resolves alerts. | Uses a paid seat |
| **Viewer** | Read-only visibility into services, active incidents, on-call schedules, and post-mortems. Cannot be paged or make changes. | **Free & Unlimited** |

## Free Viewer Seats

Unlike traditional incident management vendors that bill for every user in the directory, OnCallAlert includes **unlimited free viewer seats** on all plans. Stakeholders, customer success managers, and engineering executives can observe real-time incident status without consuming paid responder licenses.

## CLI Role Management

If an instance is left without an active Owner, an operator with shell access to the host or container can promote any user using the CLI:

```bash
docker exec -it oncallalert oncallalert set-role --user admin@example.com --role owner
```
