What's new in 2025.2

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
• 9409 - The MachinePolicyId property in deployment targets and workers will now return the default machine policy ID for the space if the given machine doesn't have a MachinePolicyId set. This is a breaking change if you rely on the nullable behavior of the MachinePolicyId property

Other Changes

• 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
• 9406 - Fix bug allowing steps to be created with blank worker pools
• 9428 - Fix blank spaces not being stripped from script module filenames
• 9423 - Short network issues between Octopus and Tentacle can leave scripts executing on Tentacle, preventing further deployments on the tentacle.
• 9412 - Default to operations page in CaC projects with CaC Runbooks when there are only Runbooks (and no deployment process) in the project
• 9422 - Upgraded Autofac dependency to 8.3.0
• 9418 - Random crash in job scheduler
• 9369 - Improved warning message when attempting to deploy project that is dependent on missing git resources
• 9417 - Automatically retry if package acquisition fails due to a transient error
• 9419 - Updated OpenTelemetry to version 1.11.2 to fix CVE-2025-27513
• 9403 - Fix inconsistency between schedule times and timezones when viewing freeze schedules in countries that observe daylight savings
• 9416 - Revert the change that would return the default machine policy id from the create deployment target endpoint, as this led to extra permissions being required when modifying the deployment target
• 9324 - Underscore in a Script Module name will be stripped during deployment when loaded from source
• 9411 - Show exact branch and tag matches at the top of the list in the branch selector in Config as Code projects
• 9410 - Resilient Deployments not Raising Deployment/Runbook Run Started Event
• 9414 - Tenant common variables can now be scoped to environments
• 9357 - Once step retries have been enabled, they cannot be disabled because backoff can't be set back to 'null'
• 9378 - Send status update to Jira when a deployment is canceled
• 9401 - Build Information version matching has been updated to support versions with leading zeros
• 9400 - Improve audit events for variable sets
• 9399 - Fix environment link on lifecycle page to redirect to the environments page instead of infrastructure
• 9413 - Add support for concurrently writing to task logs in multi node setups.
• 9398 - Update step template usage table to only show relevant data for database backed projects
• 8801 - Fix step retry and timeout settings being reset when an associated step template is updated
• 9395 - Fix Azure script steps incorrectly defaulting to use Octopus bundled Azure tooling
• 9396 - Azure Bundled Tooling Still Used - Script Console with WebApp Targets
• 9397 - Azure Bundled Tooling Still Used - Custom Step Template using Run a Script Step against WebApp Target
• 9387 - Triggers are running for disabled projects
• 9393 - Fix agent selection on Kubernetes monitor upgrade dialog
• 9389 - Added support for using worker credentials to authenticate into AWS Elastic Container Registry feeds
• 9391 - "Change Password" button no longer appears on users page if username/password authentication is disabled
• 9390 - Display warning/error if Tentacle is using SHA-1
• 9373 - Fixed IIS Deployment Step failing when using PowerShell Core 7.3+
• 9360 - Helm Deployment Error when creating a Resource - 'Resource "" not found' and 'Error reading JObject from JsonReader'
• 9363 - Current Version shown in Deployment Preview one version behind current
• 9379 - Release preview not showing latest deployed release
• 8796 - Changed package name generation to produce shorter file names which reduce long path errors
• 9338 - Allow configuring the AWS Region for an S3 Bucket Feed
• 9356 - Unexpected error message when worker pool is empty
• 9375 - Fixed an issue where filtering server tasks by interruptions sometimes returned tasks that weren’t actually interrupted
• 9374 - Added the ability to compare changes in Kubernetes manifests between deployments
• 9381 - Fixed an issue where a Kubernetes manifest would be empty in the Applied Manifests view
• 9352 - Replaced the broken link with a functioning and more stable oc.to link. This link was also replaced with the working link in the docs in this pr.
• 9362 - Fix sample payload for project git conversion endpoint in Swagger UI
• 9372 - Fixed incorrect detection of package parameter when updating package references on a Run a Script step
• 9371 - Fixes bug that prevented KOS from failing a deployment early when a Kubernetes job with a Backoff limit of zero has failed
• 9346 - Add support for Change Controlled Runbooks
• 9370 - Moved global deployment freezes to enterprise license
• 9366 - Added support for priority runbooks (requires enterprise license)
• 9367 - Moved priority deployments to enterprise license
• 9359 - Deselect authentication type when changing feed types so OIDC form is updated
• 7409 - Fixed issue retrieving docker image labels for multi-arch images
• 9358 - Added new audit events for reporting usage of PTM entitlements
• 9353 - Feature usage telemetry now includes the number of packages stored in the built-in package feed
• 9344 - Fix Offline Drop with Git-sourced Package
• 8798 - Fix missing step template usages for version-controlled projects
• 9343 - Added support for variable enumeration in bash using associative arrays. This uses the octopus_parameters field and requires the feature toggle BashParametersArrayFeatureToggle to be enabled, bash version 4.2 or later and xxd on path
• 9345 - Suppressed an error that caused deployments to fail when some Kubernetes manifests could not be parsed
• 9339 - Fixed issue when using Runbook Triggers with CaC Runbooks. When the trigger creates multiple runs, a failure to create one run would prevent the creation of the remaining runs for that trigger invocation
• 9334 - Added the ability to filter tasks by a tenant tag
• 9282 - Fixed the runbook 'Publish' button not showing correctly when editing a runbook process in some circumstances
• 9332 - Fixed incorrect current version being shown in deployment preview
• 9337 - Support version-controlled projects when exporting projects from Octopus
• 9331 - Fix no gap between Connectivity text and machine health status icon in the links sidebar on machines
• 9329 - Improved the design and UX of top-level pages for better consistency across the app
• 9328 - Fixed an issue where only up to 100 Jira work items could be retrieved; Fixed an issue where work items were being retrieved for all versions of packages
• 9325 - Fix child steps not respecting run conditions
• 9321 - ACR and GCR feeds now save with the correct feed type. Telemetry also includes them as seperate counts
• 9320 - Removes validation for username on SMTP for username and password authentication method
• 9316 - Fixed "Load more" button still being shown after loading all deployments in the release
• 9309 - Fixed missing DLL issue when using AAD username/password authentication for Azure Service Fabric
• 9313 - Fixed an issue where version controlled project variable pages weren't being displayed at full width
• 9297 - Fixed Force Package Download option not being respected on automatic deployments
• 9289 - Fixed an issue where editing variable sets on Tenants page redirected to a default space
• 9308 - Fixed an issue with the dashboard onboarding page showing no permissions when a user has scoped permissions assigned
• 9311 - Fix regression that removed faded colour from older releases on the project dashboard
• 9306 - Fixes issue where Operations page within a project would fail to load with Sequence contains no matching element error
• 9302 - The Insights APIs are now officially supported and available. They can be used to create Insights reports as well as retrieve the metrics for projects and reports
• 9305 - Fix overriding existing project common tenant variable values when updating missing variables
• 9304 - Fix - unsaved changes lost when changing filters or variable set view options
• 9291 - Weekly and Monthly Recurring Deployment Freezes now activate correctly if times crosses date lines due to time zones
• 9296 - Update retention policy for tasks to clean up frequent server tasks
• 9287 - Helm feed urls no longer require trailing when downloading directly on targets
• 9274 - Support using OAuth 2.0 for authentication into Microsoft's SMTP Server using federation credentials
• 9275 - Replaced Certificate Fails to Open
• 9290 - Migrate Release and RunbookSnapshot table to include new field for process template references. Note: This change involves a database migration of releases which may take upwards of a few minutes. If you have many releases (over hundreds of thousands), we recommend more aggressive release retention settings for a quicker upgrade
• 8262 - Custom authentication providers (Okta, AAD, etc) now work with virtual directories
• 8263 - Azure AD integration using a client secret does not work with Octopus bindings using a Virtual directory
• 9283 - Unscoped tenant common and project variables are returned as missing for all environments
• 9272 - Increased the space name and slug length limits to 50 characters
• 9269 - Recent feature usage telemetry data is included in the diagnostics data, if available
• 9271 - Add support for Runbooks in Config as Code
• 9258 - Fix for "unable to evaluate tokens" warnings appearing in task logs for Kubernetes steps
• 9266 - Revert "Update project dashboard interface"
• 9264 - Improved resilience when creating Octopus Server config file
• 9262 - Fix recurring deployment freeze schedule incorrectly reporting as active
• 9260 - Removed experimental message from ARM SSH targets and workers
• 9259 - Update project dashboard interface
• 9247 - Fixed import/export for git-sourced deployment steps and step templates using git credentials