Octopus Server compatibility
The table below outlines the backward compatibility between Octopus Server and related components
| Octopus Server | Octopus.Client & Octopus CLI (octo) | Calamari | Tentacle | TeamCity Plugin |
|---|---|---|---|---|
| 3.2 | 3.2 | 3.0 ➜ latest | 3.2 | |
| 3.3 | 3.3 ➜ 4.30.3 | 3.3 | 3.0 ➜ latest | 3.3 ➜ latest |
| 3.4 | 3.3 ➜ 4.30.3 | 3.4 | 3.0 ➜ latest | 3.3 ➜ latest |
| 3.5 ➜ 2018.2 | 3.3 ➜ 4.30.3 | 3.5 ➜ latest | 3.0 ➜ latest | 3.3 ➜ latest |
| 2018.2 ➜ 2018.12 | 4.30.7 ➜ 4.47.0 | 3.5 ➜ latest | 3.0 ➜ latest | 3.3 ➜ latest |
| 2019.1* | 5.0.0 ➜ 5.2.7 | 3.5 ➜ latest | 4.0 ➜ latest | 5.0 ➜ latest |
| 2019.2* ➜ latest | 6.0.0 ➜ latest | 3.5 ➜ latest | 4.0 ➜ latest | 5.0 ➜ latest |
* Partial forward compatibility
Older versions of some libraries and plugins may work with 2019.1 and higher only if the default space is enabled and such integrations are only used against that space. To make use of other spaces, please upgrade.
However, 2019.1 also carries some breaking changes to the API so care must be taken when upgrading from a prior version that existing integrations are not affected. There is a comprehensive rundown of these changes available in our downloads section.
The table below outlines partially forwards compatible scenarios between Octopus Server and related components
| Octopus Server | Octopus.Client & Octopus CLI (octo) | Calamari | Tentacle | TeamCity Plugin |
|---|---|---|---|---|
| 2019.1 ➜ latest | 4.30.7 ➜ 4.47.0 | 3.5 ➜ 4.12.0 | 3.0 ➜ 3.25 | 3.3 ➜ latest |
Operating System compatibility
We recommend using an up to date version of Windows Server for Octopus which is generally one of the last two versions of Windows Server. The table below outlines the backward compatibility of Octopus and Windows Server editions.
| Octopus Server | Minimum Windows Server version |
|---|---|
| 2020.1 ➜ latest | Server 2012 R2+ |
| 2019.4 ➜ 2019.13 | Server 2008 R2 |
| 3.1 ➜ 2019.3 | Server 2008+ |
| 1.0 ➜ 3.0 | Server 2003+ |
SQL Server compatibility
We recommend using an up to date version of SQL Server for Octopus which is generally one of the last versions of SQL Server for security, and performance benefits. The table below outlines the backward compatibility of Octopus and SQL Server editions.
| Octopus Server | Minimum SQL Server version | Azure SQL |
|---|---|---|
| 2020.2.x ➜ latest | SQL Server 2016+ | Supported |
| 3.0 ➜ 2019.13 | SQL Server 2008+ | Supported |
The following versions of Octopus have a requirement for SQL Server 2017+.
- 2020.2.0 ➜ 2020.2.17
- 2020.3.0 ➜ 2020.3.5
This requirement has been relaxed to SQL Server 2016+ for any patch version later than specified in this note. Please see this post for further details.
In Octopus 1.0 ➜ 2.6.5 it used RavenDB and we switched to SQL in Octopus 3.0. You can read more about it in our blog post.
Help us continuously improve
Please let us know if you have any feedback about this page.
Page updated on Sunday, January 1, 2023