Octopus Cloud Task Cap

Every Octopus Deploy instance has set number of concurrent tasks it can process. That number of concurrent tasks is known as the Octopus Task Cap.

A task can be:

• Deployments
• Runbook run
• Retention Policies
• Health Checks
• Let’s Encrypt
• Process triggers
• Process subscriptions
• Script console run
• Sync built-in package repository
• Sync community library step-templates
• Tentacle upgrade
• Upgrade Calamari
• Active Directory sync

The most common tasks are deployments and runbook runs.

The default task cap for Octopus Cloud instances is based on the license tier:

• Starter: 5
• Professional: 5
• Enterprise: 20

Self-hosted customers have more control over their task cap. As such, every self-hosted instance starts out with a task cap of 5. A higher task cap requires more hosting resources. Self-hosted customers can change their instance’s task cap via the Octopus Deploy UI. That is because self-hosted customers take on the responsibility of allocating resources, and paying any additional Azure, AWS, or GCP fees.

Increasing the Task Cap for Octopus Cloud

Octopus Cloud customers must contact our Sales team to increase the task cap.

Octopus Cloud provides the following Task Cap options:

• Starter: 5
• Professional: 5, 10, 20
• Enterprise: 20, 40, 80, 160

Increasing the task cap will incur a corresponding increase in platform fees. Deployments and runbook runs are computationally expensive. More concurrent deployments and runbook runs requires more resources from the Octopus Cloud platform.

We assign resources to each Octopus Cloud instance based on the task cap. Changing the task cap changes those resources. That requires a small outage as the instance and database are reprovisioned. We will wait until your next maintenance window to perform that reprovisioning. You might not see a change in the task cap until the next day.

Please note: If you need a task cap higher than 160 please contact our Sales team to discuss your use case. These options are meant to cover the majority of use cases.

Important: 5, 10, 20, 40, 80, and 160 are the only options we offer. If you want an instance with a task cap above 160, again, contact our Sales team. There are no options between those tiers. For example, no Octopus Cloud instance can have a task cap of 15, 34, 45, or 68.

How to choose a task cap

We recommend task caps based upon the number and duration of deployments required for a production deployment. Deployments and runbook runs are the most common tasks. Deployments typically take longer than runbook runs. Production deployments are time constrained. They are done off-hours during an outage window.

Important: These tables represent the MAX number of deployments. Additional tasks such as runbook runs, retention policies, or health checks can reduce the number. Use these tables as guidelines.

Task Cap 5

Task Cap 10

Task Cap 20

Task Cap 40

Task Cap 80

Task Cap 160