> ## Documentation Index
> Fetch the complete documentation index at: https://docs.therefrain.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Runbooks

> Create, edit, and manage runbooks in the Web Console.

## Overview

The Runbooks page lets you manage all your runbooks — create new ones, edit YAML, and track versions.

## Creating a runbook

<Steps>
  <Step title="Click New Runbook">
    From the runbooks list, click the **New Runbook** button (requires Developer role or above).
  </Step>

  <Step title="Write and edit">
    Write your runbook YAML, editing steps and variables as needed.
  </Step>

  <Step title="Save">
    Save the runbook. It starts in draft status.
  </Step>
</Steps>

## Editing a runbook

From the runbook detail page, you can:

* **Edit YAML** — Modify the runbook definition directly
* **Edit steps** — View and modify individual steps
* **Edit variables** — Add, remove, or change variable definitions

Changes create a new version (see Versioning below).

## Versioning

Runbooks support versioning to track changes over time:

| Action              | Description                                    |
| ------------------- | ---------------------------------------------- |
| **Create version**  | Save current state as a new version            |
| **Publish version** | Set a version as the active production version |
| **Rollback**        | Revert to a previous version (Business+)       |

Version limits depend on your plan:

| Plan       | Max versions |
| ---------- | :----------: |
| Team       |      10      |
| Business   |      50      |
| Enterprise |   Unlimited  |

## Running a runbook

From the runbook detail page:

1. Click **Run** to execute in normal mode
2. Click **Self-heal** to run with aggressive retry and repair suggestions
3. Provide any required variables and secrets
4. Monitor the job in real-time on the [Jobs](/console/jobs) page

## Managing runbooks

| Action         | Required role | Description               |
| -------------- | :-----------: | ------------------------- |
| Create         |   Developer+  | Create a new runbook      |
| Edit           |   Developer+  | Modify runbook content    |
| Run            |    Member+    | Execute the runbook       |
| Verify/Publish |     Admin+    | Publish a runbook version |
| Duplicate      |   Developer+  | Create a copy             |
| Delete         |     Admin+    | Permanently remove        |

## Approval workflow

With Business+ plan, you can enable an approval workflow that requires admin approval before publishing new runbook versions. Configure this in [Settings > Development](/console/execution-settings).