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 2024.2.9409 to 2024.3.11587

Octopus 2024.3

The 2024.3 release of Octopus Deploy has updates to increase simplicity and efficiency in your deployment processes.

This release’s noteworthy updates include:

  • Introducing the new Vertical Navigation UI
  • Optimized infrastructure use with our autoscaling worker that Octopus manages for you
  • Improvements to the Helm Upgrade step for simpler setup
  • More secure Git workflows with Git protection rules
  • Simpler and faster navigation
  • Configurable deployment freezes to make it easier to manage deployments
  • Streamlined approvals for manual interventions
  • .NET 8 upgrade

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

Octopus 2024.2

The 2024.2 release of Octopus Deploy has updates to further improve our Kubernetes functionality and simplify deployments and operations.

This release’s noteworthy updates include:

  • Simpler deployments to Kubernetes with the Kubernetes agent
  • External feed triggers for Kubernetes for automated releases
  • Improved visibility and management of variables for tenanted deployments
  • ServiceNow integration improvements to provide greater control of change requests
  • Better visibility of key account information with the license usage dashboard
  • Performance improvements for a faster task queue
  • Additional performance improvements
    • Support for Windows 10 LTSC
    • SSH.NET Library upgrade with SHA 256 support

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

Release notes

These are the features and fixes you'll get by upgrading from 2024.2.9409 to 2024.3.11587.

Changes in Octopus Server 2024.3.11587

  • 8977 - Migrate VariableSet table to use Entity Framework
  • 8981 - Fixed: Modifying Deployment Settings via the /projects/Projects-N endpoint in the API could discard some values
  • 8913 - Fix a bug where packages weren't being re-acquired after manual intervention steps
  • 8980 - Add support to scope prompted project variables to channels
  • 8979 - Fixed an issue where variable substitution was not run on Helm template values files sourced from packages or git repositories
  • 8348 - Fixed an issue where modifying inline scripts failed due to persisting script parameters

Changes in Octopus Server 2024.3.10989

  • 8542 - Fixed issue where creating a Release or Runbook Snapshot fails if one or more steps have a git dependency referencing variables
  • 8973 - When running Offline Drop scripts as administrator, the working location is now changed from C:\WINDOWS\system32 to the directory containing the bundle
  • 8913 - Fix a bug where packages weren't being re-acquired after manual intervention steps

Changes in Octopus Server 2024.3.10840

  • 8971 - Fixed issue where attempting to deploy certain older releases with primary Git references may result in a "Value cannot be null" error

Changes in Octopus Server 2024.3.10714

  • 8970 - Fix constraint violation error when deleting some old Deployments or RunbookRuns
  • 8969 - Inspect target execution context for custom Calamari environment variable
  • 8886 - New Git protection rules have been added to channels allowing you to restrict which branches and tags can be used when using Git repositories during deployments
  • 8968 - Support Automatic Updates for Kubernetes Agent Helm Chart Within Major Version Stream
  • 8962 - Migrate NuGetPackage table to use Entity Framework

Changes in Octopus Server 2024.3.9887

  • 8963 - Fixed an issue where deploying a Git-sourced Bicep template may result in an error
  • 8914 - Fix bug with needs approval tab on tasks page - show message for multiple approvals on a task
  • 8960 - Migrate ServerTaskApproval table to use Entity Framework
  • 8952 - Migrate RunbookRun table to use Entity Framework
  • 8958 - Converted DeploymentFreeze document persistence from JSON store to relational model
  • 8959 - Fixed an issue where helm template values packages or git repositories would get a -Infinity index
  • 8946 - Loading the deployments related to releases no longer causes an error when more than 300 deployments exist
  • 8956 - Release Note: Converted BulkDeployment document from JSON store to relational model
  • 8879 - Converted Interruption document persistence from JSON store to relational model
  • 8951 - Fix a broken link navigating from all variables to tenant variables page

Changes in Octopus Server 2024.3.9242

  • 8954 - Allow configuring force package download option when creating a runbook
  • 8941 - Migrate ActionTemplate and ActionTemplateVersion table to use Entity Framework
  • 8953 - Fixed an issue during tool extraction via Bash when chown is denied
  • 8794 - Correct build information and release notes are shown when a variable is used as a package name and multiple variables values are set with various scoping
  • 8181 - Fixed an issue where extracting the Java archive as an additional package was causing the step to fail
  • 8945 - Migrate Deployment table to use Entity Framework
  • 8944 - Convert Project to use Entity Framework
  • 8948 - Fix Runbook run now page calling incorrect preview endpoint for published snapshots
  • 8862 - Migrate Certificate table to use Entity Framework
  • 8932 - Converted ServerTask document persistence from JSON store to relational model
  • 8943 - Kubernetes agent is now generally available and our recommended Kubernetes deployment target. See our announcement blog post
  • 9009 - Step Templates sourced from Git can cause a deployment to fail when deploying in parallel
  • 8950 - Fixed a bug where Script Source wasn't being set when creating new Deploy a Helm Chart steps
  • 8906 - Azure Web App steps failing when no resourceGroup value is set.
  • 6914 - Produce correctly formatted filenames when transferring a package from Windows to Linux

Changes in Octopus Server 2024.3.8336

  • 8906 - Azure Web App steps failing when no resourceGroup value is set.

Changes in Octopus Server 2024.3.8206

  • 8938 - Fixed an issue where the new projects dashboard rendering felt sluggish
  • 8933 - Fixes handling of deleted branches and other Git errors so that the channels screen will not error

Changes in Octopus Server 2024.3.7892

  • 8931 - Fix "Edit Step" link not working on Runbook Task List
  • 8920 - Migrate Account table to use Entity Framework
  • 8929 - Migrate Channel table to use Entity Framework
  • 8903 - Migrate TagSet table to use Entity Framework
  • 8927 - Resolved an issue where the Kubernetes agent was erroneously using step-configured execution container details as the script pod container image for certain Kubernetes steps

Changes in Octopus Server 2024.3.7660

Breaking Changes
  • 8918 - Breaking Change: We've modified the way Target Tags (previously known as Target Roles) work under the hood. Some Tags may now be visible to a wider audience than they were before. If you have custom roles that you expect to be able to see or manage Target Tags, you may also need to add new permissions to those roles
Other Changes
  • 5161 - The Project > Releases page no longer queries for every task in the history of the universe
  • 8923 - Fixed an issue where failing or in progress deployments were not being prioritized on the new projects page as part of the new vertical navigation
  • 8925 - Fixed a bug where the environment headers on the Projects Page might sometimes be in a different order from the deployment table cells
  • 8926 - Fixed a bug that prevented environment filters from being applied to the Projects page
  • 8915 - Rotation date calculation on the signing keys page better accounts for time zones
  • 8481 - Fix a bug where runbooks runs are blocked from being created if there are multiple prompted variable values for the same variable
  • 8922 - Auto select JSON or YAML syntax highlighting when editing variable values
  • 8912 - Fix external security group sync failing with deadlock errors

Changes in Octopus Server 2024.3.7046

  • 8733 - Fix conflicting ID when converting multiple value variables to sensitive
  • 8909 - Fix Runbook cloning dialog in the Octopus portal creating a new empty Runbook rather than cloning
  • 8910 - Convert ProjectTrigger to Entity Framework
  • 8208 - URLs for Releases may exceed 4000 characters due to many Tenants / Deployments
  • 5161 - The Project > Releases page no longer queries for every task in the history of the universe
  • 8905 - Fix issue where scheduled deployment time was inaccurate

Changes in Octopus Server 2024.3.6389

  • 8900 - Fixed an issue where execution containers images in custom registries were not being correctly retrieved when using the Kubernetes agent
  • 6914 - Produce correctly formatted filenames when transferring a package from Windows to Linux
  • 8836 - Migrate GitCredential table to use Entity Framework

Changes in Octopus Server 2024.3.6198

  • 8899 - Automatically expand script source when using inline YAML in Kubernetes Step
  • 7616 - Scheduled deployments select the correct release to promote when there are multiple tenanted deployment candidates
  • 8898 - Fixed an issue where tasks menu item was incorrectly hidden in the new vertical navigation when user has task view permissions in a different space
  • 8828 - Fixed audit event not showing a correct value for the variable set and library variable set snapshots when updating a release variable

Changes in Octopus Server 2024.3.5617

  • 8869 - email is no longer used as an identifying value for ActiveDirectory users. Emails are now correctly pulled from AD when looking up a user data after a user is created in Octopus
  • 8896 - Step retries no longer retry after Tentacle communication errors
  • 8888 - Fixed an issue with Kubernetes Server-side apply running on Windows workers
  • 8704 - Scheduled tasks now show the remaining time until their start time on the tasks page
  • 8890 - Exposed license usage page in GA versions
  • 8891 - Fixes ssh targets when md5 hashed fingerprints are used

Changes in Octopus Server 2024.3.5388

  • 8894 - Added support for opting out of isolated execution on C# dotnet-script steps. To opt out set the variable Octopus.Action.Script.CSharp.BypassIsolation to true
  • 8892 - Fix an issue where tenant logos were cut off on the project dashboard if the tenant had a long name
  • 8720 - Fixed issue where default filters on the Deployments page were not applied correctly
  • 8424 - Fix a bug where certain steps (e.g. manual intervention, email) were copying target roles of parent steps
  • 8889 - Improve UX of expanding rows on the tenants page

Changes in Octopus Server 2024.3.4944

  • 8791 - Deployments using multiple workers in a single Worker Pool acquire different workers when packages overlap or subsequent steps do not use packages.
  • 8842 - Fixed an issue preventing Tentacle upgrades on Linux initiated by Octopus Server from falling back to using an archive file for installation if yum or apt-get fails/is unavailable
  • 8884 - Fix dashboard incorrectly showing onboarding prompt
  • 8605 - Fix Azure App Service steps failing to deploy when the step is added from a step template or cloned from an existing step, and a Docker feed is used
  • 8887 - Enhance target tag selector so that tags are added on blur, enter and tab
  • 8882 - Show Proxy details configured via environment variables on the Web Request Proxy page

Changes in Octopus Server 2024.3.4762

  • 8881 - Log HTTP 500 errors correctly in the web request logging file

Changes in Octopus Server 2024.3.4152

  • 8842 - Fixed an issue preventing Tentacle upgrades on Linux initiated by Octopus Server from falling back to using an archive file for installation if yum or apt-get fails/is unavailable
  • 8878 - Added indentation markers to the code editor for when editing YAML. Fixed a small bug in the code editor, where the editor will now remain focused when you drag select outside of the editor region
  • 8871 - Migrate DeploymentSettings table to use Entity Framework
  • 8876 - Fix issue where health checks on Cloud Regions fail
  • 8880 - Align fonts on project variables and tenant variables to be 14px monospaced. Improve some styling on the tenant variables page
  • 8832 - Improves help text for Deploy a CloudFormation Template step so that it doesn't imply that only JSON templates are supported
  • 8877 - Convert ProjectTriggerExecution to Entity Framework
  • 8864 - Migrate Lifecycle table to use Entity Framework
  • 8873 - Convert DeploymentCompletion to Entity Framework
  • 8866 - Migrate Feed to use Entity Framework
  • 8868 - Fixed UI performance regression on variable edit page
  • 8867 - Large Variables page with lots of scopes is slow to add new value
  • 8872 - Migrate AutoDeployQueueItem to use Entity Framework
  • 8874 - Created new experimental optimization for the data source of the new Projects page
  • 8727 - Fixed an issue where async zip deploy failed to clean up packages resulting in failed tasks

Changes in Octopus Server 2024.3.3636

  • 8855 - Convert InsightsReport to use Entity Framework
  • 8870 - Upgrade CodeMirror from v5 to v6 and apply new code editor theme for better syntax highlighting
  • 8865 - Don't map work items in build information on pages that don't show this information
  • 8861 - Convert MessageBusCursor and MessageBusEvent to Entity Framework
  • 8863 - Converted DeploymentFreezeOverride document persistence from JSON store to relational model
  • 8841 - Ensure SQL connections are closed when encountering exceptions during disposal
  • 8844 - Migrate CommunityActionTemplate table to use Entity Framework
  • 8858 - Octopus.Release.CurrentForEnvironment.Number is blank on a deployment after a runbook snapshot/run.
  • 8850 - Migrate LibraryVariableSet table to use Entity Framework
  • 8860 - Removes start delay for Polling Tentacles https://github.com/OctopusDeploy/Issues/issues/8860
  • 8857 - Fixed an issue where certificate metadata validation returns a byte array and throws an exception when using non string inputs like otherName.1 = 1.3.6.1.4.1.111.20.2.3;UTF8:<mailto:0111111111@test.gov|0111111111@test.gov>
  • 8853 - Audit event for non-scheduled deployments should indicate it was immediately deployed

Changes in Octopus Server 2024.3.3075

  • 8836 - Migrate GitCredential table to use Entity Framework
  • 8854 - Improved performance of account usage across variable snapshots

Changes in Octopus Server 2024.3.2716

  • 8852 - Added "Edit" deeplinks to Process steps in Runbook logs
  • 8851 - Migrate DataMigrationState table to use Entity Framework
  • 8847 - Converted DashboardConfiguration document persistence from JSON store to relational model
  • 8849 - Enable new Project Tenant Variables view by default
  • 8819 - Migrate WorkerTaskLease table to use Entity Framework
  • 8841 - Ensure SQL connections are closed when encountering exceptions during disposal
  • 8824 - Migrate Space table to use Entity Framework
  • 8821 - Migrate MachinePolicy table to use Entity Framework

Changes in Octopus Server 2024.3.2222

  • 8727 - Fixed an issue where async zip deploy failed to clean up packages resulting in failed tasks
  • 8845 - Deleting projects or environments removes them from deployment freeze scope
  • 8839 - Fixed a duplicate key exception when building telemetry information
  • 8843 - Fixed Add Worker page defaulting to non-existent Kubernetes category
  • 8831 - Converted Subscription document persistence from JSON store to relational model
  • 8834 - Migrate ConnectProjectToTenantsTask table to use Entity Framework

Changes in Octopus Server 2024.3.1881

  • 8792 - Improve Git persistence logic to better detect and recover from corrupt repositories
  • 8837 - Converted DatabaseMaintenance document persistence from JSON store to relational model
  • 8835 - Deprecation of Helm V2 support
  • 8833 - Stopped auditing document modifications for newly queued tasks
  • 8826 - Fixed an issue where very large packages (4+ GB) failed to download from an external feed
  • 8064 - Correctly set windowsFxVersion when deploying containers to a Windows-based container Azure Web App
  • 8827 - Add automatic retry when acquiring packages/containers from Docker, OCI Helm and Artifactory feeds
  • 8818 - Octopus RestAPI create release unable to include / in package name
  • 282 - Create Release --package=VALUE - Unable to include / in package name in value
  • 8823 - Converted Proxy document persistence from JSON store to relational model
  • 8443 - Added the ability to edit the Project Lifecycle from the Project Settings page
  • 8820 - Missing Jira work items will not block release creation
  • 8816 - Converted OctopusServerNodeStatus document persistence from JSON store to relational model
  • 8799 - Upgraded BouncyCastle.Cryptography dependency from 2.2.1 to 2.3.1

Changes in Octopus Server 2024.3.1025

  • 8808 - Migrate DynamicInfrastructureLifecycle table to use Entity Framework
  • 8803 - Migrate ProjectIntents table to use Entity Framework
  • 8815 - Rename Library to Git Credentials in Git Repository authentication selector
  • 8812 - Migrate KubernetesTaskResourceStatus table to use Entity Framework
  • 8809 - Fix issue where git repository packages are always re-acquired on target, even if it's the exact same package
  • 8806 - Fixed case-sensitive name filter on Infrastructure Workers page
  • 8804 - Migrate DeprovisionDynamicEnvironmentTask table to use Entity Framework
  • 8805 - Converted OctopusServerNode document persistence from JSON store to relational model

Changes in Octopus Server 2024.3.531

  • 8807 - Improve UX when viewing build information on deployments
  • 8800 - Migrate DeprovisionDynamicEnvironmentForProjectTask table to use Entity Framework
  • 8795 - Account type variable values will use account ID not account name if clicking on 'All Variables' or 'Variable Preview' page and then refreshing that page.
  • 8802 - Support skipping initial health check when creating deployment targets or workers
  • 8793 - Deploying to an environment and a frozen environment at the same time no longer results in a validation error
  • 8797 - Fixed an issue with deployments not always including packages for the same offline drop target when deploying simultaneously

Changes in Octopus Server 2024.3.164

  • 8792 - Improve Git persistence logic to better detect and recover from corrupt repositories
  • 8785 - Added an optional --cancel-wait parameter in Octopus Server's node command to set the time to wait after task cancellation is requested
  • 8775 - Added background migration to remove duplicate Build Information commits and work items from Deployments

Changes in Octopus Server 2024.2.9409

  • 8913 - Fix a bug where packages weren't being re-acquired after manual intervention steps