Octopus Deploy Documentation

Multi-region Deployment Pattern

Last updated


Your application is deployed to multiple geographic regions (or multiple Data Centers) to provide for your end-customer's performance (think latency) or legal requirements (like data sovereignty).

Strict Solution Using Environments

You can use Environments to represent each region or data center. In the example below we have defined a Dev and Test Environment as per normal, and then configured two "production" Environments, one for each region we want to deploy into.

By using this pattern you can:

  1. Use Lifecycles to define a strict process for promotion of releases between your regions. Lifecycles can be used to design both simple and complex promotion processes.
  • For example, you may want to test releases in Australia before rolling them out to the USA, and then to Europe.
  • In another example, you may want to test releases in Australia before rolling them out simultaneously to all other regions.
  1. Scope region-specific variables to the region-specific Environments.
  2. Quickly see which releases are deployed to which regions on the main dashboard.
  3. Quickly promote releases through your regions using the Project Overview.
  4. Use Scheduled Deployments to plan deployments for times of low usage.

This is a really good solution if you want to enforce a particular order of deployments through your regions.

Rolling Solution

In Octopus 3.4 we introduced Cloud Regions which enable you to configure Rolling deployments across your regions or data centers. In this case you can scope variables to the Cloud Regions and deploy to all regions at once, but you cannot control the order in which the rolling deployment executes.

By using this pattern you can:

  1. Scope region-specific variables to the Cloud Region targets.
  2. Conveniently deploy to all regions at the same time.

If you don't really mind which order you regions are deployed, or you always upgrade all regions at the same time, Cloud Regions are probably the right fit for you.

Tenanted Solution

Alternatively you could create Tenants to represent each region or data center. By doing so you can:

  1. Use Variable Templates to prompt you for the variables required for each region (like the storage account details for that region) and when you introduce a new region Octopus will prompt you for the missing variables:

  1. Provide logos for your regions to make them easier to distinguish:

  1. Quickly see the progress of deploying the latest release to your entire production environment on the main dashboard:

  1. Quickly see which releases have been deployed to which regions using the Dashboard and Project Overview:

  1. Quickly promote releases to your production regions, in a particular sequence, or simultaneously:

  1. Use Scheduled Deployments to plan deployments for times of low usage:

You do give up the advantage of enforcing the order in which you deploy your application to your regions, but you gain the flexibility to promote to your regions in different order depending on the circumstances.

Tenants offer a balanced approach to modeling multi-region deployments, offering a measure of control and flexibility.


EnvironmentsTenants and Cloud Regions can be used to model multi-region deployments in Octopus, but each different choice is optimized to a particular style of situation. Choose the one that suits your needs best!

Welcome! We use cookies and data about how you use our website allow us to improve the website and your experience, and resolve technical errors. Our website uses cookies and shares some of your data with third party analytics companies for these purposes.

If you decline, we will respect your privacy. A single cookie will be used in your browser to remember your preference.