﻿# First Runbook Run

This tutorial will help you complete your first runbook run using a sample script on one or more of your servers.  The only prerequisite is a running Octopus Deploy instance, either in Octopus Cloud or self-hosted.  The tutorial will walk through configuring deployment targets.

This tutorial will take between **15-25 minutes** to complete, with each step taking between **2-3** minutes to complete.  

1. [Configure environments](/docs/getting-started/first-runbook-run/configure-runbook-environments)
1. [Create a project](/docs/getting-started/first-runbook-run/create-runbook-projects)
1. [Create a runbook](/docs/getting-started/first-runbook-run/create-a-runbook)
1. [Define a runbook process to run on workers](/docs/getting-started/first-runbook-run/define-the-runbook-process)
1. [Running a runbook](/docs/getting-started/first-runbook-run/running-a-runbook)
1. [Defining and using runbook variables](/docs/getting-started/first-runbook-run/runbook-specific-variables)
1. [Adding deployment targets](/docs/getting-started/first-runbook-run/add-runbook-deployment-targets)
1. [Update runbook process to run on deployment targets](/docs/getting-started/first-runbook-run/define-the-runbook-process-for-targets)
1. [Publishing a runbook](/docs/getting-started/first-runbook-run/publishing-a-runbook)

Before starting the tutorial, if you haven't set up an Octopus Deploy instance, please do so by selecting one of the following options:

- [Octopus Cloud](https://octopus.com/free-signup) -> we host the Octopus Deploy instance for you, it connects to your servers.
- [Self-hosted on a Windows Server](https://octopus.com/free-signup) -> you host it on your infrastructure by [downloading our MSI](https://octopus.com/download) and installing it onto a Windows Server with a SQL Server backend.  Learn more about [our installation requirements](/docs/installation/requirements).
- [Self-hosted as a Docker container](https://octopus.com/blog/introducing-linux-docker-image) -> you run Octopus Deploy in a Docker container.  You will still need a [free license](https://octopus.com/free-signup).

When you have an instance running, go to the [configure runbook environments page](/docs/getting-started/first-runbook-run/configure-runbook-environments) to get started.

**Further Reading**

This tutorial will run a sample script, first on the default worker or your server; then, it will move onto running that script on your servers.  If you prefer to skip that and start configuring Octopus Deploy runbooks to meet your requirements, please see:

- [Runbook Documentation](/docs/runbooks) 
- [Runbook Examples](/docs/runbooks/runbook-examples)
