Documentation menu

Your first runbook run in Octopus Deploy

Use Octopus docs with AI

Create a runbook in Octopus Deploy

Add a runbook to your Octopus Deploy project. Follow the step-by-step guide to create the runbook, name it, and prepare it for defining process steps.

A single Octopus Deploy Project can have multiple Runbooks. Each Runbook has a unique runbook process, retention policy, and allowable environments to run in. For example, a project might have a runbook to spin up additional infrastructure, or restart the server, or perform a daily backup.

example runbook

  1. From the Hello world project you created on the previous page, click OPERATIONS on the left menu to expand it (if it is not already expanded).
  2. Click GO TO RUNBOOKS.
  3. Click ADD RUNBOOK.
  4. Give the Runbook a name, for example, Hello Runbook and click SAVE.

The next step will define a simple runbook process to run on either the Octopus Server or a worker (if you are using Octopus Cloud).

Further Reading:

For further reading on Runbooks please see: