Tenant types

Tenants in Octopus can represent multiple use cases:

  • Software as a Service (SaaS)
  • Geographical regions or data centers
  • Developers, testers, or teams
  • Feature branches

This section covers some of the common tenancy types you can model with Octopus.

Software as a Service (SaaS)

Software as a Service (SaaS) is perhaps the most common implementation of multi-tenancy with Octopus Deploy. The SaaS model is where the same software is deployed to multiple customers (tenants). The deployment process can include items such as custom branding per tenant or scoping specific steps to tenant tags so that modules can be deployed to tenants that have purchased them.

Tenants using the SaaS model typically fall into three distinct categories:

  • Code based
  • Database based
  • Isolated

Code-based multi-tenancy

Code-based tenancy is where all tenants share the same infrastructure and itโ€™s up to the code to determine what a tenant sees and has access to. Code based multi-tenancy can be the easiest option to deploy and maintain, but there are tradeoffs. There is a risk for cross tenant contamination. A missed โ€œwhereโ€ clause makes for a terrible day. You also cannot deploy different versions of the application to different tenants.

Database multi-tenancy

Database based tenancy is similar to Code based, however, each tenant has their own database. Deploying the application is easy, but deploying the database changes can be harder than the first approach. Database changes need to be deployed to all databases prior an application update. Having a large number of databases will create a bottleneck in the deployment.

Isolated multi-tenancy

Isolated is where each tenant has their own, dedicated infrastructure. This removes the risk of cross tenant data contamination, but it complicates deployments. The deployment process itself may not change, but the application now has to be deployed per tenant. Each deployment has to configure the application instance for that tenant. The complication to the deployment process offers flexibility and scalability to the application and its deployments. Tenants can now be upgraded independently and be hosted on hardware that fits their needs.

Learn more about how to to configure multi-tenancy for a SaaS application in Octopus with our multi-tenant SaaS guide.

Geographical regions or data centers

Another pattern for multi-tenancy is to treat geographic regions of the same organization as tenants. Using this model, something like an e-commerce application can test out new or beta features in a specific region before releasing them out to the rest of the organization. Scheduling deployments during a maintenance window is another way this pattern can be used as each region may have different hours when they are least busy.

Learn more about how to to configure multi-tenancy for regions in Octopus with our multi-tenant regions guide.


Concurrent application development is another multi-tenant use-case. Using tenants for teams allows an Octopus administrator to re-use the same deployment process as well as environments giving each team the autonomy to deploy. You can assign tenant tags or dedicate specific tenants to deployment targets so each team can deploy without affecting the other.

Learn more about how to to configure multi-tenancy for teams in Octopus with our multi-tenant teams guide.

Help us continuously improve

Please let us know if you have any feedback about this page.

Send feedback

Page updated on Thursday, December 7, 2023