Released: Thursday, September 11, 2025
What's new in 2025.3
These are the most important features you'll get by upgrading.
Octopus 2025.3
The new features in Octopus 2025.3 offer clearer insights, faster testing, and better performance.
This release’s noteworthy updates include:
- Monitor and troubleshoot Kubernetes apps in one place with Live Object Status
- Faster, safer, and more cost-effective testing with Ephemeral Environments - Early Access Preview
- Improve performance with more control over package retention policies
- Greater control over complex processes with a modernized Process Editor
The 2025 Q3 release is already available on Octopus Cloud and is now ready for download by our self-hosted customers.
Release notes
Changes in Octopus Server 2025.3.14271
Breaking Changes
- 9447 - Breaking change: Update the way the
tags
andexcludedTags
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
- 9597 - Additional warnings around Azure Cloud Services (classic)
- 9592 - Add v2 endpoints for getting and modifying deployment and runbook processes
- 9508 - Removed support on Linux self-hosted and Cloud for SHA-1 certificates in Octopus Tentacle
- 9575 - Update Microsoft.Data.SqlClient dependency to 6.1.1
- 9587 - Updated Event RelatedDocumentIds to include ProjectGroupId
- 9584 - Fix issue where parameter selectors appeared empty in Step Templates
- 9585 - Unable to navigate to Projects page after creating a new project in a new space
- 9590 - Add a "Test" tab to the Variable Preview page. This tab can be used to quickly iterate on complex variable expressions instead of having to deploy to view results
- 9583 - Added
NodeSelector
option to the Kubernetes UI deployment step - 9572 - Fixed an issue where the audience property is missing from Generic OIDC accounts when referenced from a Step Template
- 9537 - Resolved an issue where the Upgrade Tentacles menu item was not being shown on the Deployment Targets and Environments pages
- 9524 - Added the ability to source helm template values from the version control project repository
- 9578 - Support binding the Execution Container Feed on a deployment step
- 9388 - Fixed Run an AWS CLI script step template so parameters can be selected from Insert Variable button
- 9573 - Fixed an issue where configuring and testing Google Container Registry feeds failed with a null reference error
- 9510 - Support for defining custom claims on OIDC accounts
- 9568 - Fixed invalid lifecycle retention settings preventing viewing of lifecycles
- 9569 - Support octal values for inline YAML on deployment steps
- 9545 - Check if a change request can transition to state before attempting to transition to the state
- 9566 - Fixed an issue that caused retention policies to be set to 0 days
- 9562 - Machine prechecks will now be skipped if the relevant information is already available from the last health check
- 9565 - Improve telemetry tracing around the use of the GitHub Api
- 9555 - Upgrade Autofac Dependency to 8.4.0
- 9561 - Fix node drain wait always quitting after 5 minutes
- 9560 - Add page for setting space default lifecycle retention settings
- 9556 - Add default option for retention settings on the lifecycle page
- 9559 - Add pessimistic concurrency locks to GitHub token refresh logic to avoid race condition errors when multiple releases for a version controlled project are made in parallel
- 9558 - Fixed Deploy to NGINX, Deploy a Windows Service and Deploy to IIS steps so they display the Package section
- 9547 - Add centralized runbook retention setting behind feature flag 'centralize-retention'
- 9554 - Fix generated default stack name in Create S3 Bucket step
- 9453 - Allow package acquisition on the execution target for Helm and K8s YAML steps
- 9551 - Support fetching OCI manifests for package release notes
- 9538 - Completed Kubernetes jobs will be filtered from Kubernetes Live Object Status views
- 9542 - The copy of Octopus.Client.dll bundled with the Windows Octopus Server installation is now built targeting netstandard2.0 instead of net462. We do not expect this to cause any compatibility problems, but if it does please contact Octopus Support
- 9540 - Updated variable set page pagination text
- 9541 - Fixed a bug preventing lifecycles from importing between Octopus versions
- 8744 - Adds support for sourcing files from Git repositories to
Deploy an Azure Resource Manager template
andDeploy an AWS CloudFormation template
steps - 9544 - Add subscription events for adding and deleting built-in packages
- 9532 - Variables containing ISO-8601 date strings are not being preserved
- 9533 - Fix error displaying Kubernetes manifests with an empty
annotations
key - 9534 - Add
PlatformHubView
andPlatformHubEdit
permissions - 9463 - Fixed issue where Project Variables dialog blocked the Add Account drawer
- 9530 - Filter out UI only and offline nodes when configuring a Kubernetes agent in a Octopus HA cluster
- 9529 - Added support for SMTP Azure Communication Services by allowing custom OAuth scopes
- 9526 - Clean up tenant variables that have been orphaned due to deleted or disconnected tenants
- 9522 - Support project group slug in OIDC subject claims
- 9521 - Added support for slugs on Project Groups
- 9520 - Fix feed selector state mismatch when toggling container image options
- 9525 - Using ScriptServiceV1 on the V2 Execution Pipeline can cause 'long file path' issues on some Windows-based Tentacles
- 9500 - "Skip Tenants where
is the current version" can yield unexpected behavior if all included tenants are skipped - 9518 - Certain page titles have been changed to achieve a more consistent naming strategy
- 9465 - Fix bug when referencing account and certificate variable types from a variable set within a project template
- 9516 - Allow S3 external feeds to be used to source helm values
- 9284 - Add option to fail cloud discovery steps if no matching targets are found
- 9514 - Remove environment from runbooks when the environment is deleted
- 9490 - Fixed Bug preventing users from adding or editing project tenant variables using the same template if they exist in different projects
- 9512 - In a Config as Code project, if the step name exceeds 63 characters, Kubernetes steps fail to deploy
- 9505 - Fixed an issue where conflicting accounts on a step and target may lead to errors running the step
- 9515 - Fixed an issue where reference packages couldn't change their acquisition location as the UI was erroneously hidden
- 9513 - Fix Kubernetes object snapshots not saving when using Config as Code projects with step names >50 characters long
- 9504 - Resolved issue where feature toggle scoped to an environment was preventing deletion
- 9495 - Variables that are scoped to tenanted deployment targets now pass pre-deployment validation when deploying to their respective tenants
- 9502 - Populate the
ProcessTemplateUsages
property in processes if a process template is added. If saving to OCL, these will be stored asprocess_template
blocks in processes - 9496 - Package matching when creating a release is once again case insensitive
- 9501 - Allow the Kubernetes agent to be installed without the monitor
- 8937 - Fix Tasklog copy to clipboard
- 9494 - Add
ProcessTemplateUsages
andProcessOrder
to the export and audit JSON for deployment and runbook processes - 9492 - Fixed missing package warning showing on release page incorrectly
- 9485 - Display Kubernetes monitor status when installing Kubernetes agent
- 9489 - Add new concepts to deployment and runbook processes to enable upcoming process templates work. Note: This change involves a database migration of these tables which may take upwards of a few minutes. If you have many releases or runbook runs (over hundreds of thousands), we recommend more aggressive retention settings for a quicker upgrade
- 9488 - Fixed raw task log styling
- 9486 - Add repository link to git commit badges for GitHub and GitLab hosted repos
- 9484 - The "Blocking Task" list no longer displays when there are no blocking tasks
- 9480 - Releases with packages that are sourced from a variable no longer appear in the missing packages warning
- 9482 - ServerUrl exposed from OIDC endpoint is not updated when the property is updated
- 9476 - Fix scroll position doesn’t reset when adding or viewing Deployment process step
- 9474 - Web Cookie encryption updated to AES256 where master keys are 256-bit in length. This may cause a one-time re-authentication for some customers
- 9509 - Add Git credential repository restrictions
- 9473 - Deployment throws an
EntityNotFoundException
when accessing deployment target created during deployment - 9467 - Updates page areas in global search to match current navigation structure
- 9470 - Retry worker leasing when all healthy workers are leased exclusively
- 9466 - Add support for evaluating the value of
Octopus.Action.TargetRoles
on a step if the value uses the Octopus binding syntax - 9330 - Fixed an issue that left variable set snapshots orphaned
- 9110 - Fix an issue where updating the retention policies cron expression did not reschedule the related retention policies job
- 9454 - Update onboarding message on space-level insights page when you don't have an enterprise license
- 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
- 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
- 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
- 9435 - Adding ability to Manage API Keys in Configuration
- 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
Unsure which version is a compatible upgrade? Compare releases.
Looking for older versions of Octopus? Download older versions.