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 2025.2.12885 to 2025.3.1670

Octopus 2025.3

No highlights for 2025.3

Octopus 2025.2

The 2025.2 release of Octopus Deploy helps you improve visibility into Kubernetes deployments, create repeatable processes for efficiency, and make compliance easier to manage at scale.

This release’s noteworthy updates include:

  • Inspect Kubernetes manifests from within Octopus for improved observability
  • Easily manage your Octopus instance with the Octopus Terraform Provider
  • Scope common tenant variables to environments for simpler deployments at scale
  • Additions and improvements to our Enterprise tier offering
  • Configurable project-level deployment freezes for greater control over deployments
  • Easily monitor license usage by adding it as an event type to your subscriptions
  • More secure connectivity for external feeds with expanded support for OpenID Connect (OIDC)

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

Release notes

These are the features and fixes you'll get by upgrading from 2025.2.12885 to 2025.3.1670.

Changes in Octopus Server 2025.3.1670

Breaking Changes
  • 9452 - The default C# scripting engine has been updated to dotnet-script, replacing ScriptCS. This is a breaking change. To temporarily revert, set the Octopus.Action.Script.CSharp.UseDotnetScript variable to false. Support for ScriptCS will be removed in 2025.3. For more details see our deprecation schedule and migration guide
  • 9447 - Breaking change: Update the way the tags and excludedTags query parameters are set on the tenants overview page. If you are using a saved link with multiple tags in the same tag set filter, you'll need to re-apply these filters and re-save the link as the URL format has changed
Other Changes
  • 9454 - Update onboarding message on space-level insights page when you don't have an enterprise license
  • 9453 - Allow package acquisition on the execution target for Helm and K8s YAML steps
  • 9348 - Jira Base Url setting will error if a trailing slash / is present
  • 6206 - Jira Base Url Configuration Forward-Slash
  • 9445 - Added UI callout for service account OIDC subject if only wildcards are used
  • 9285 - Fix a bug where making multiple changes on the create deployment page could result in stale results showing for the deployments preview
  • 9406 - Fix bug allowing steps to be created with blank worker pools
  • 9440 - Revert change that introduced bug that prevents editing a step that uses a worker pool variable
  • 9444 - A new certificate created for a tenant variable will be initialized to that tenant to reduce chance of misconfiguration
  • 9443 - Jira work item numbers will now be parsed from commit messages and branch names
  • 9429 - Fix release package notes continuing to display a loading state after loading has failed

Changes in Octopus Server 2025.3.839

  • 9122 - Updated error message to include possible solutions to resolve the issue
  • 9441 - Fix unable to select input components in the new project creation dialog triggered from the global search bar
  • 8830 - Added new service message ##octopus[stderr-output] to print stderr logs as info logs
  • 9442 - Initial connection to an SSH endpoint will retry for transient errors
  • 9440 - Revert change that introduced bug that prevents editing a step that uses a worker pool variable
  • 9421 - Configurable package cache retention for workers and targets
  • 9439 - Improve start time clarity for scheduled tasks
  • 9437 - FSharp (F#) scripts are no longer supported and will result in failed deployments. Deployment processes containing F# scripts can still be loaded and modified, but F# script execution will result in deployment failures
  • 9436 - Replace references to Octo.exe and Octopack.js with Octopus CLI
  • 9427 - Add storage level check to default bash health checks
  • 9415 - Improve performance of Azure Run a Script powershell scripts
  • 9433 - Artifactory Generic Feeds using OIDC and incorrectly displaying as the selected authentication method when selecting a Token
  • 9435 - Adding ability to Manage API Keys in Configuration
  • 9432 - Deselecting project when creating deployment freeze removes project from dialog altogether
  • 9434 - Reduced database storage for variable sets by not serialising default property values
  • 9383 - Improve helm feed error messages
  • 9430 - Automatically re-hash CA certificates in the OctopusDeploy Linux docker image
  • 9426 - Removing deployment target during deployment with large variable sets can have performance problems
  • 9406 - Fix bug allowing steps to be created with blank worker pools

Changes in Octopus Server 2025.2.12885

Breaking Changes
  • 9452 - The default C# scripting engine has been updated to dotnet-script, replacing ScriptCS. This is a breaking change. To temporarily revert, set the Octopus.Action.Script.CSharp.UseDotnetScript variable to false. Support for ScriptCS will be removed in 2025.3. For more details see our deprecation schedule and migration guide
Other Changes
  • 9348 - Jira Base Url setting will error if a trailing slash / is present
  • 6206 - Jira Base Url Configuration Forward-Slash
  • 9440 - Revert change that introduced bug that prevents editing a step that uses a worker pool variable
  • 9433 - Artifactory Generic Feeds using OIDC and incorrectly displaying as the selected authentication method when selecting a Token
  • 9432 - Deselecting project when creating deployment freeze removes project from dialog altogether
  • 9426 - Removing deployment target during deployment with large variable sets can have performance problems
  • 9406 - Fix bug allowing steps to be created with blank worker pools