Octopus Deploy Documentation

Setup Octopus Deploy

Last updated

Octopus deploy is available in two variants:

Self-hosted Octopus Server

If you want to host the Octopus Server on infrastructure of your choosing, you can download the installer, install the server, and manage it on infrastructure of your choice, providing it meets the installation requirements.

You will also need to maintain the server, backup the database, and apply upgrades.

Install the self-hosted Octopus Server

To install the Octopus Server on a supported Windows Server, complete the following steps:

  1. Download the Octopus Deploy installer.
  2. Start the installer and follow the setup wizard prompts.
  3. Click Finish to exit the installer and grant Octopus.Manager.Server permission to make changes to your device.
  4. Click Get started..., follow the on-screen instructions, and accept the defaults.
  5. On the Database page, follow the instructions to download and install SQL Server Express.
  6. Click the drop-down arrow in the Server Name field to detect the SQL Server database. Octopus will create the database for you.
  7. Continue to follow the prompts, and click Finished when the installation has completed.

Your self-hosted Octopus Server is now ready to use.

Before you do anything else, click the View Master Key link, copy your Master Key, and store it somewhere safe.

To launch the Octopus Web Portal, click Open in browser from the Octopus Manager and log in with the credentials you configured during the installation process.

For more information and other installation options, see the installation documentation.

Now that you've installed the self-hosted Octopus Server, it's time to explore the Octopus Web Portal.

Octopus Cloud

Octopus Cloud is the hosted version of Octopus. We host the Octopus Server on your behalf and take responsibility for the underlying infrastructure and upgrading the server so you are using the latest features of the platform.

Create an Octopus Cloud instance

To create an Octopus Cloud instance, you need to first create an Octopus account, and then you can create your Octopus Cloud instance:

You can register for an account with your existing Google or Microsoft account or create a unique login for Octopus:

  1. Enter your name.

  2. Provide your email address and create a password.

  3. On the next screen, verify your email address.

  4. After your email has been verified, you will be logged into your Octopus account. To create a new instance of Octopus Cloud, make sure you are logged into your Octopus account:

  5. Click Create a new cloud instance.

  6. Enter the URL you would like to use to access your instance: <yoururl>.octopus.app. If the URL you selected is not available, enter a different URL.

  7. Select the region where you would like your instance to be hosted.

  8. Add your company name.

  9. Review the terms of our customer agreement, privacy policy, and acceptable usage policy.

  10. Click Agree, deploy my Octopus!.

You will be taken to the account provisioning screen. Your Octopus Cloud instance should be ready within a minute or so. You will receive an email when the instance is ready to use.

When your Octopus Cloud instance is ready, you can log in at the URL you defined during the registration process: <yoururl>.octopus.app.

To learn more about Octopus Cloud, see the Octopus Cloud documentation.

Now that you've created an Octopus Cloud instance, it's time to explore the Octopus Web Portal or you can return to the getting started guides.

Need support? We're here to help.