# Runbook

> Written steps to fix a known problem. Anyone can follow them, even when tired.

**Field:** Infrastructure  
**Category:** Reliability  
**Also known as:** Playbook (Operations), Operations Runbook, Run Book

## Think of it like

It is like the steps on a fire safety card. You follow them without having to think.

## Definition

A runbook is a written set of steps for a known task or problem. It says what to check, what to type and what to expect back. A good alert links to the runbook for it. Then a tired person at 3 a.m. can fix the problem safely. The most used runbooks are often turned into scripts later.

## Example

The disk full alert links to a runbook. It lists the command to find big files, which logs are safe to delete and when to call for help.

## Why it matters

It puts what the best expert knows into the hands of whoever is on call.

## Common mistake

Writing a runbook once and never updating it. Steps that no longer work are worse than none.

## Three principles

- **Step by step.** What to check, type and expect.
- **Linked from alerts.** The alert points to its runbook.
- **Kept current.** Fixed every time a step goes stale.

## Related terms

- [On-Call](https://learn.benibix.com/term/infrastructure/on-call)
- [Incident (IT)](https://learn.benibix.com/term/infrastructure/incident)
- [Alerting](https://learn.benibix.com/term/infrastructure/alerting)
- [Postmortem](https://learn.benibix.com/term/infrastructure/postmortem)
- [Game Day](https://learn.benibix.com/term/infrastructure/game-day)
- [Toil](https://learn.benibix.com/term/infrastructure/toil)

## Told apart from

- [Playbook vs Runbook](https://learn.benibix.com/compare/playbook-vs-runbook): People think a playbook and a runbook are the same thing, and they are not. A runbook gives one fixed set of steps for a known problem, so anyone can follow it. A playbook offers a few proven moves for a situation, and people pick the one that fits. In IT teams the two words are sometimes swapped.

![A timeline from left to right. Something breaks. An alert fires and pages the person on call. They open the runbook and fix it, and the service is back. The span from break to back is marked as time to recover. After that, a postmortem is written, and its actions feed back to the start.](https://learn.benibix.com/diagrams/inf-incident-timeline.svg)

---

Source: https://learn.benibix.com/term/infrastructure/runbook
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-19
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
