Compare releases

Compare releases and check for compatibility between your existing Octopus Server and new releases.

What's new

These are the most important features you'll get by upgrading from 2023.3.13280 to 2024.1.8032

Octopus 2024.1

The 2024.1 release of Octopus Deploy has updates to make your deployments simpler to manage and more secure and efficient.

This release’s noteworthy updates include:

  • More secure connectivity to AWS using OpenID Connect (OIDC)
  • Artifactory Generic Repositories now supported in Octopus
  • Faster feedback loops with inline execution containers
  • Improved performance with Octopus Server upgraded to .NET 8
  • Building on Resilient Tentacle Communications
  • Improved page layouts for easier navigation

The 2024 Q1 release is already available on Octopus Cloud and now ready for download by our self-hosted customers.

Breaking changes

Workers and Targets Running Windows Server 2003 and unpatched Windows Server 2008 Operating Systems will no longer be functional

Recent updates to our execution engine necessitate the minimal requirement of .NET 4.6.2 on Windows Targets and Workers. Due to the support capabilities of the .NET Framework, this requirement excludes Windows 2003 Servers, and Windows 2008 Servers that do not have the latest service patches installed.

Learn more about this change in the GitHub issue.

Octopus 2023.4

The 2023.4 release of Octopus Deploy has a number of updates to make your deployments simpler to manage and more resilient.

This release’s noteworthy updates include:

  • More secure connectivity to GitHub and Azure using OpenID Connect (OIDC)
  • Source scripts from Git to maintain them like other assets
  • Resilient Tentacle communications to reduce deployment failures
  • Elevate critical tasks to the top of the task queue
  • Connect tenants to multiple projects in one step
  • Space ID now available on Terraform resources to simplify configuration

The 2023 Q4 release is available on Octopus Cloud and ready for download by our self-hosted customers.

Octopus 2023.3

The 2023.3 release of Octopus Deploy has a number of updates to improve deployment efficiency and speed at scale.

This release’s noteworthy updates include:

  • Easier management of tenants at scale with bulk actions
  • Improved container deployments with support for OCI Helm registries
  • Fewer manual interventions with configurable step timeouts
  • More control over audit logs with adjustable retention
  • Source Kubernetes configuration files from Git for simpler deployments
  • Modify YAML files for Kubernetes with our new Kustomize Step
  • Additional functionality for AKS customers with support for kubelogin for AKS clusters
  • Step template improvements to make updates easier to manage
  • UI performance improvements to the Releases and Create Release pages for a better experience while deploying

The 2023 Q3 release is available on Octopus Cloud and ready for download by our self-hosted customers.

Release notes

These are the features and fixes you'll get by upgrading from 2023.3.13280 to 2024.1.8032.

Changes in Octopus Server 2024.1.8032

Breaking Changes
  • 8548 - Windows Server 2003 and un-patched Windows Server 2008 Targets no longer function and Windows Server 2012 and below now require NET462 to be installed.
Other Changes
  • 8541 - Fixed an issue where projects could not be connected to a tenant when the user had correctly scoped permissions
  • 8540 - Added telemetry on Tentacle versions
  • 8527 - Deployments containing templated script-steps which source scripts from a git repository, successfully run to completion. Existing (failing) steps must be recreated to resolve deployment failures

Changes in Octopus Server 2024.1.7598

  • 8557 - Add support for Wildcards in OIDC subjects
  • 8556 - Creating the Json serializers used for communications to Tentacles can consume lots of resources when deploying to many tentacles.

Changes in Octopus Server 2024.1.7120

  • 8554 - Block the creation of any new Azure Cloud resources in Octopus as part of the deprecation of Azure Cloud Services
  • 8553 - Fixed missing AWS OIDC account named variables
  • 8552 - Fixed a bug where the insights report filter was not preserved when navigating to the overview report page

Changes in Octopus Server 2024.1.6809

  • 8551 - Fixes a regression where steps relying on an EC2 instance role would cause deployments to fail
  • 8535 - Cancelling a deployment queued to a Polling Tentacle that has recently disconnected does not stop RPC retries
  • 8541 - Fixed an issue where projects could not be connected to a tenant when the user had correctly scoped permissions
  • 8546 - Fix downloading certificate in Original format
  • 8444 - Tentacle health checks keep a transaction open for every machine for the duration of the check

Changes in Octopus Server 2024.1.6245

  • 8530 - Fixed a bug where selecting username password account in the variable editor throws an exception

Changes in Octopus Server 2024.1.5804

  • 8539 - Support revoking JWT Auth Tokens through the existing user session revocation functionality
  • 8538 - Tasks running on Windows 2008 machines will start logging warnings for upcoming dropping of support
  • 8472 - Display all user roles when editing team
  • 8555 - Add a warning message about the upcoming deprecation of F# scripting
  • 8534 - The Help Sidebar has been updated to include embedded videos, refreshed content and relevant links
  • 8537 - Resolved performance degradation that particularly affected the progression API by restoring caching mechanism
  • 8365 - Fixed a visual bug where the missing variables icon would not be removed from the sidebar when updating a tenant's variables

Changes in Octopus Server 2024.1.5446

  • 8536 - Fixed a regression where exporting multiple projects under a same project group fails
  • 8533 - Fix API requests for projects associated with a lifecycle not responding
  • 8514 - The audit archive screen now displays nicely when there are no audit archives
  • 8157 - Fixed an issue where the 'Deploy an AWS CloudFormation template' Step Template Does Not Apply Tags when using Change Sets
  • 8671 - Fixed issue with overly long transaction names
  • 8529 - Resolved performance degradation in variable endpoints by restoring caching mechanism

Changes in Octopus Server 2024.1.5024

  • 8528 - Links to documents in the Audit log showing a "Resource is not found" error
  • 8515 - Reduced the length of a Tentacle workspace directory name from ~55 characters to ~22 characters
  • 8496 - Co-operatively cancel Requests to Tentacle

Changes in Octopus Server 2024.1.4489

Breaking Changes
  • 8146 - Deprecating Mono support for deployments on SSH Targets
Other Changes
  • 8524 - Updated the bundled Tentacle version to fix an issue where restarting a Windows Listening Tentacle may not free up the listening port. Impacts Tentacle version 8.0.0 to 8.1.61. A Tentacle upgrade is required to get this fix
  • 8513 - Minor visual and textual improvements of Kubernetes step expanders
  • 8494 - Fixed a regression where a power user weren't able to change other user's passwords via the UI
  • 8506 - Fixed alignment of bind icon in some account select inputs
  • 8507 - Improved performance in publication of internal messages

Changes in Octopus Server 2024.1.3649

  • 8433 - Fixed an issue with package references not saving when using CAC on Step Package Framework steps, currently this only impacts the bicep step
  • 8508 - Fixed a bug preventing the deployment of releases created before a config-as-code conversion
  • 8495 - Enable TCP Keepalives between Octopus Server and Tentacle
  • 8503 - Update Octopus Server to .NET 8
  • 8438 - The Help Sidebar has been overhauled. It now has adjustable width, embedded YouTube videos and a simplified layout, among other smaller improvements
  • 8502 - Fixed a bug where the page would permanently load when viewing a deployment process without FeedView
  • 8492 - Add numbered pagination to the tenanted project overview dashboard and reduce amount of data being loaded
  • 8485 - Fix server tasks sometimes failing to initialize

Changes in Octopus Server 2024.1.2962

  • 8499 - Fixed embedded video files not playing on some browsers
  • 8497 - Update the version of NodeJS bundled with Octopus used for steps
  • 8507 - Improved performance in publication of internal messages

Changes in Octopus Server 2024.1.2702

  • 8489 - Fixed authentication issue with the kustomize step when using an Azure OIDC account
  • 8488 - Fix some project links broken on narrow screen widths
  • 8478 - Add support for parsing version numbers for packages that include a leading v character
  • 8484 - Slightly adjusted how the dashboard data is loaded
  • 5096 - IIS deployment fails when there are multiple SSL certificates and they are in different stores
  • 7668 - Fix the S3 Feed not searching for packages in folders. Make the search case sensitive to match S3 behavior. Add support for any file extension

Changes in Octopus Server 2024.1.2344

  • 8487 - Improved our Page Layouts UX
  • 8483 - Targets and Workers running Windows Server 2012 R2 or earlier will generate warnings in health checks if not running .NET 462 or later
  • 8480 - Improvements made to user sessions to allow for better management these changes. With the roll out of these changes, it will unfortunately cause existing user sessions to be invalidated and users will be forced to log back in
  • 8477 - Tasks UI - Re-add "All" view as the default view for Tasks

Changes in Octopus Server 2024.1.2059

  • 8558 - Added support for authenticating to the Octopus API using OpenID Connect
  • 8469 - Fixed a broken link from the Audit screen to a Scoped User Role

Changes in Octopus Server 2024.1.1743

  • 7996 - Fix incorrect task duration when using manual intervention steps
  • 7468 - Deployment task page shows incorrect "ran for" time for process with Manual Intervention step
  • 8475 - Fix publish button UI for runbook snapshots
  • 8476 - The upload to S3 step now only allows package selection from compatible feeds
  • 8473 - Fixed an error when interacting with a version controlled deployment process with a system level team as the responsible team on a Manual intervention step
  • 8465 - Fix saving step templates that reference a script in a git repository
  • 8461 - Update all Tasks pages to show Running/Waiting/Completed tabs
  • 8470 - Support OCI feed sub-paths in Harbor
  • 8466 - Added a performance feedback survey to the navigation bar
  • 8455 - Fixed an issue where the project versioning strategy could be put in an invalid state
  • 8458 - Running and waiting task counts should now display the correct number of tasks when filters are applied
  • 8457 - Allow user to cancel server task from the Tasks list
  • 8532 - Reduced default concurrent message pumps to alleviate thread pool pressure
  • 8464 - Fixed Add/Modify ProjectGroup returning 500 when it should return 409
  • 8429 - Increased the default number of Thread Pool threads and Database Connections

Changes in Octopus Server 2024.1.746

  • 8459 - Fixed issue with the Deploy Raw Kubernetes Yaml step where you couldn’t save when sourcing yaml from a Git Repository
  • 8448 - Waiting tasks are now displayed in the expected execution order on the Tasks page. Each queued task displays its respective placement in the queue
  • 8450 - Make server task prioritization part of the public API
  • 8441 - Add container options to k8s targets
  • 8447 - Reduced the amount of data loaded to display teams in the UI

Changes in Octopus Server 2024.1.437

  • 8452 - Fixed a bug on the Tasks page which caused paging to not work
  • 8453 - Deployment Target and Worker lists now display the target type
  • 8449 - ReferenceIds on StepFramework steps are incorrectly updated when updating step versions, this leads to a mismatch between the referenceId and StepPackageInputsReferenceId causing deployment failures
  • 8446 - Add support for sub paths on an OCI registry feed URI
  • 8635 - Converted ProjectGroup document persistence from JSON store to relational model
  • 8445 - "Move to Top" option is missing for queued server tasks
  • 8329 - Added support for Inline Execution Containers
  • 8402 - Added tooltips to accommodate for long project names in the project-switcher
  • 8436 - Separate the table on the Tasks page into three tabs - Running, Waiting and Completed
  • 8442 - Scripts can now be sourced from Git repositories
  • 8406 - Changed Netfx Calamari filesystem recursive operations to use the .NetFramework provided methods instead of AlphaFS due to performance issues

Changes in Octopus Server 2023.4.8231

  • 8527 - Deployments containing templated script-steps which source scripts from a git repository, successfully run to completion. Existing (failing) steps must be recreated to resolve deployment failures

Changes in Octopus Server 2023.4.8196

  • 8537 - Resolved performance degradation that particularly affected the progression API by restoring caching mechanism

Changes in Octopus Server 2023.4.8185

  • 8533 - Fix API requests for projects associated with a lifecycle not responding
  • 8671 - Fixed issue with overly long transaction names

Changes in Octopus Server 2023.4.8166

  • 8529 - Resolved performance degradation in variable endpoints by restoring caching mechanism

Changes in Octopus Server 2023.4.8154

  • 8515 - Reduced the length of a Tentacle workspace directory name from ~55 characters to ~22 characters

Changes in Octopus Server 2023.4.8125

  • 8507 - Improved performance in publication of internal messages

Changes in Octopus Server 2023.4.8116

  • 8489 - Fixed authentication issue with the kustomize step when using an Azure OIDC account

Changes in Octopus Server 2023.4.8101

  • 5096 - IIS deployment fails when there are multiple SSL certificates and they are in different stores
  • 7668 - Fix the S3 Feed not searching for packages in folders. Make the search case sensitive to match S3 behavior. Add support for any file extension

Changes in Octopus Server 2023.4.8082

  • 8558 - Added support for authenticating to the Octopus API using OpenID Connect
  • 8465 - Fix saving step templates that reference a script in a git repository
  • 8470 - Support OCI feed sub-paths in Harbor
  • 8532 - Reduced default concurrent message pumps to alleviate thread pool pressure
  • 8429 - Increased the default number of Thread Pool threads and Database Connections
  • 8447 - Reduced the amount of data loaded to display teams in the UI
  • 8449 - ReferenceIds on StepFramework steps are incorrectly updated when updating step versions, this leads to a mismatch between the referenceId and StepPackageInputsReferenceId causing deployment failures
  • 8446 - Add support for sub paths on an OCI registry feed URI
  • 8442 - Scripts can now be sourced from Git repositories
  • 8406 - Changed Netfx Calamari filesystem recursive operations to use the .NetFramework provided methods instead of AlphaFS due to performance issues

Changes in Octopus Server 2023.4.7951

  • 8418 - Bug fix: Validate step name uniqueness when reading a cac deployment process
  • 8426 - Prioritized tasks now show the correct position in the queue on the Task summary page
  • 8439 - Fixed alignment of "Sign in with your Octopus ID" button label
  • 8437 - Filter out runtime properties when extracting step template from action
  • 8432 - Set FeatureToggle default to true for Event-Based DeploymentHistory and RunbookRunHistory updates
  • 8435 - Octopus Server Manager and Built In Extension files are now signed with Authenticode

Changes in Octopus Server 2023.4.7608

  • 8406 - Changed Netfx Calamari filesystem recursive operations to use the .NetFramework provided methods instead of AlphaFS due to performance issues
  • 8431 - Fix missing gap between buttons when editing a lifecycle
  • 8411 - Improve transaction names in diagnostic reports
  • 8423 - Fix scheduled release creation with package versioning strategy
  • 8412 - Added validation for the auth session timeout to prevent setting it to a value that is too short

Changes in Octopus Server 2023.4.7210

  • 8425 - Fix bug where tentacle upgrade ignores patch versions
  • 8421 - Improve callout on Task Summary page to accurately reflect the entire task queue, and update naming of Task Progress to Blocking Tasks
  • 8422 - Recovering from Communication Errors with Tentacle on by Default
  • 8420 - Removal of both MultiGlobPathsForRawYamlInvertedFeatureToggle and GitSourcedYamlManifestsReverseFeatureToggle feature flags

Changes in Octopus Server 2023.4.6612

  • 8419 - "Run a Docker Container" Step No Longer Allows for Selecting a Feed
  • 8405 - Server tasks can now be moved to the top of the queue from the Tasks page or Task detail page
  • 7382 - Fixed issue with deploying zip files to Azure when executing within the built-in worker
  • 8362 - Fixed issue with accessing additional files in a helm package with a nested path
  • 8392 - Session Timeouts with values less than the default timeout(20 minutes) will now no longer cause the authentication cookie to refresh on every API request and will refresh when necessary
  • 8407 - Fixing creating deployment for project with CaC when OCL path in release gitref is not available
  • 8393 - Ensure variables can be used in package references for CaC projects when using scheduled triggers
  • 8398 - When redeploying a tenanted deployment and selecting a tenant tag the skip tenant panel is displayed and allows deploying to tenants that already have the release as their current version
  • 8399 - Reinstate grace period for licenses under original agreement

Changes in Octopus Server 2023.4.6162

  • 8415 - Fixed an issue where using a variable for the container Package Feed removes the Package ID field
  • 8388 - AzureAD authentication now supports group overruns
  • 8343 - The ssl-certificate command will reject expired certificates by default. Use --skip-certificate-date-validation to bypass this validation
  • 8353 - Fixed an issue where some azure deployments did not respect proxy configured in Octopus
  • 7498 - Use run condition of child step when cloning to a different project
  • 8400 - Added number of active tasks in other spaces to the Tasks page below existing statistics for current space(s)

Changes in Octopus Server 2023.4.5740

  • 8397 - Allow existing releases to continue to deploy after moving cac directory
  • 8395 - Updated the position of the last published chip for Runbooks to be consistent with other chips
  • 8360 - Include full SSL Cert Chain in deployed SSL cert for Nginx

Changes in Octopus Server 2023.4.5452

  • 8391 - Fix "Cannot create GitProjectReference for non-Git project" for some releases
  • 8380 - Fix janky UI when machine summary contains long name and many target roles
  • 8387 - Fix runbook cloning UI where not all runbooks are available to select
  • 8390 - Add icon selector to tenant logo editor
  • 8382 - 'Calc' variable substitution allows variable names to be enclosed in { } to overcome parsing issues
  • 8187 - Handle null values gracefully when deleting resources with the Octopus terraform provider
  • 8369 - Fixed an issue where Insights reports were not showing new deployments
  • 8368 - Deploy a Bicep Template step fails when CAC is enabled
  • 8364 - Don't run package acquisition step for targets that are unavailable and project allows skipping those targets
  • 8381 - Fixed Code Editor losing language selection when toggling full screen mode in the variable editor
  • 8384 - Fix project reference error when editing config-as-code releases
  • 8428 - Adds a new welcome dialog for trial licenses with prompts for creating a new project or a sample project
  • 8383 - Improved performance on Process Edit page for projects with large number of connected Library Variable Sets

Changes in Octopus Server 2023.4.4798

  • 8369 - Fixed an issue where Insights reports were not showing new deployments
  • 8379 - Fix a Glob Pattern parsing issue where directories ending in a trailing period ‘.’ will not be parsed correctly and fail to find any matches
  • 8401 - Add username/password account as a variable type
  • 8373 - Fix no results placeholder image partially invisible in dark mode
  • 8371 - Fixed an issue with the Azure Web App step not respecting the ResourceManagementEndpoint, breaking deployments to non-public cloud
  • 8354 - API key expiry messages now include the user associated with the API key

Changes in Octopus Server 2023.4.4265

  • 8299 - Corrected the credits.html file which lists Third Party / Open Source packages used by the Octopus Server
  • 8353 - Fixed an issue where some azure deployments did not respect proxy configured in Octopus
  • 8363 - Added worker tool image for Windows 2022 workers

Changes in Octopus Server 2023.4.3998

  • 8358 - Fix the Octopus Server Url form field failing to show when expanded in the Jira Integration settings
  • 8359 - Reintroducing ScriptCS as the default C# Script executor. dotnet-script can be used by setting the UseDotnetScriptCSharpExecutorFeatureToggle feature toggle, or by setting the Octopus.Action.Script.CSharp.UseDotnetScript variable to true
  • 8357 - Downgrade markdig to fix an issue breaking Octostache filtering on #{MyVar | MarkdownToHtml}
  • 8353 - Fixed an issue where some azure deployments did not respect proxy configured in Octopus
  • 8356 - Fix TaskQueue where identical ServerTask runs on multiple HA nodes
  • 8355 - Allow the selection of packages in Terraform step to be deferred
  • 8145 - Fixed a regression where viewing deployment targets for an environment weren't being sorted by name
  • 8345 - Added a Load More button and load all link into the Release page progression section to allow viewing of more deployments for a release
  • 8293 - Fixed Certificates to show name instead of ID when viewing All Variables in a project

Changes in Octopus Server 2023.4.3586

  • 8237 - Remodel ServerTask to avoid concurrency contention when deploying multiple deploy a release steps in parallel
  • 8340 - All Variables page hangs and errors in Spaces with lots of projects, Tenants and Tenant Variables
  • 8338 - Correctly handle variable set ids in master key rotation

Changes in Octopus Server 2023.4.3511

  • 8345 - Added a Load More button and load all link into the Release page progression section to allow viewing of more deployments for a release
  • 8331 - Updated API documentation for the /api/tenantvariables/all endpoint to clarify behaviour
  • 8339 - Fixed a bug where some error messages weren't shown on the Projects, Tenants, Insights Reports, and main Dashboard pages
  • 8327 - Clears Tentacle cache directory upon Octopus server start
  • 8341 - The user account menu now shows the user's display name in the menu and on hover
  • 8335 - Fix an issue where the release details page displayed an error for releases in a Version-controlled project that were created before the VCS conversion

Changes in Octopus Server 2023.4.2775

  • 8336 - Replaced the connect single project dialog with one that allows multiple selections when connecting a tenant to project(s)
  • 8330 - Tenanted deployment mode is preserved when a certificate is replaced

Changes in Octopus Server 2023.4.2719

Changes in Octopus Server 2023.4.1941

  • 8324 - Help Sidebar - In-Product Links are Broken - HTTP 404
  • 8318 - Improved the error logging when the event-based deployment and runbook run event handlers receive invalid data
  • 8306 - Fixed regression where tasks filtered to multiple spaces ordered tasks by space instead of descending queue time

Changes in Octopus Server 2023.4.1725

  • 8319 - Steps using Git Manifests now work with Config as Code
  • 8312 - Enable option to include or exclude missing variables warning in tenants overview
  • 8310 - The deployment journal no longer records undeployed packages
  • 7284 - Migrate C# script support from ScriptCS to dotnet-script
  • 8315 - Calamari update tasks will now run concurrently
  • 8313 - Introducing a new error callout to the Project Tenant page if any tenants fail to connect
  • 8295 - Improved load time for Deploy Release page
  • 8307 - Add a new CLI command database-upgrade-status which outputs whether starting Octopus Server will result in the database being upgraded to apply schema changes
  • 8309 - LTS backport to remove the usage of --short flag from kubectl since it has been deprecated
  • 8183 - Allow supplying arguments to container runtime when using action execution containers

Changes in Octopus Server 2023.4.939

  • 8308 - Improve performance of various API endpoints when querying large sets of data

Changes in Octopus Server 2023.4.808

  • 8304 - Added additional indexes for background processes
  • 8303 - Updated Autofac dependency from v7.0.1 to v7.1.0

Changes in Octopus Server 2023.4.296

  • 8295 - Improved load time for Deploy Release page
  • 8291 - Revert change to runbook tenant selector that caused the Run button to be disabled until unchecking Skip tenants option
  • 8296 - Fixed an issue where index maintenance would fail with "SQL error: Parameter 3 is incorrect for this statement"
  • 8292 - A new Kustomize step is now available
  • 8305 - Introducing new event-based deployment history and runbook run history processes to replace current stored procedure based processes
  • 8289 - Connecting tenants to a project can now be done in bulk and will display the current progress of any ongoing connections
  • 8288 - Fix space switcher not closing when the current space is clicked
  • 8032 - Removed showing of system events in My Recent Activity page

Changes in Octopus Server 2023.3.13280

  • 8540 - Added telemetry on Tentacle versions