Released: Thursday, 11 September 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.
Breaking changes
- 9447 - Breaking change: Update the way the
tagsandexcludedTagsquery 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
Release notes
Changes in Octopus Server 2025.3.14797
- 9892 - Fix: Use the specified region for account validation on the Run an AWS CLI Script step
Changes in Octopus Server 2025.3.14792
Changes in Octopus Server 2025.3.14747
Changes in Octopus Server 2025.3.14731
- 9831 - Added telemetry on size of directories used by Octopus
Changes in Octopus Server 2025.3.14682
- 9817 - Added telemetry for self-host customers on whether the cluster shared drive is set
Changes in Octopus Server 2025.3.14676
- 9811 - Remove SqlTableStatisticsContributor and TargetMetadataContributor from the snapshot telemetry subsystem
Changes in Octopus Server 2025.3.14667
Changes in Octopus Server 2025.3.14655
- 9801 - Added step/deployment completion statistic telemetry for self-hosted customers
Changes in Octopus Server 2025.3.14649
Changes in Octopus Server 2025.3.14622
Changes in Octopus Server 2025.3.14564
- 9775 - Updated tenant variable page to ensure variable name shows after filtering
Changes in Octopus Server 2025.3.14557
- 9737 - Fix step template update when using deferred packages in a version controlled project
Changes in Octopus Server 2025.3.14546
- 9774 - Support multiple environment scopes on the Tenant Project Variables page
Changes in Octopus Server 2025.3.14529
- 9765 - Deployment scheduler can be confusing around DST shifts
Changes in Octopus Server 2025.3.14509
- 9636 - Make missing tenant variables requests non-blocking
Changes in Octopus Server 2025.3.14485
- 9752 - Fixed an issue where Migrator could not export Azure, AWS, or Google Cloud accounts
Changes in Octopus Server 2025.3.14453
- 9726 - Updated TentacleCertificateSignatureAlgorithm telemetry collector to handle null values
Changes in Octopus Server 2025.3.14448
- 9721 - Fix scheduled trigger action "Deploy latest release to environment" not respecting channel selection
Changes in Octopus Server 2025.3.14410
Changes in Octopus Server 2025.3.14395
Changes in Octopus Server 2025.3.14372
Changes in Octopus Server 2025.3.14357
- 9669 - Fixed issue that could prevent Octopus upgrades or startup if the default gRPC port
8443is already in use
Changes in Octopus Server 2025.3.14350
- 9665 - Fixed error during migrator import affecting variable sets
Changes in Octopus Server 2025.3.14336
Changes in Octopus Server 2025.3.14320
- 9630 - Fix a bug where viewing the deployment process overview for an environment scoped step causes an error
Changes in Octopus Server 2025.3.14311
- 9632 - Add environment variable to disable performance telemetry collection
Changes in Octopus Server 2025.3.14302
- 9627 - Fix deployments with invalid Channel ID breaking project exports
Changes in Octopus Server 2025.3.14292
- 9619 - Fix exception - LINQ expression DbSet<Lifecycle>() could not be translated which was displayed when viewing releases in some projects
Changes in Octopus Server 2025.3.14287
- 9624 - Improve performance of
Script0541VariableSetEntityupgrade script
Changes in Octopus Server 2025.3.14283
- 9622 - Record MCP client information when available in the user agent string
Changes in Octopus Server 2025.3.14271
Breaking Changes
- 9447 - Breaking change: Update the way the
tagsandexcludedTagsquery 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
NodeSelectoroption 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 templateandDeploy an AWS CloudFormation templatesteps - 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
annotationskey - 9534 - Add
PlatformHubViewandPlatformHubEditpermissions - 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
ProcessTemplateUsagesproperty in processes if a process template is added. If saving to OCL, these will be stored asprocess_templateblocks 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
ProcessTemplateUsagesandProcessOrderto 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
EntityNotFoundExceptionwhen 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.TargetRoleson a step if the value uses the Octopus binding syntax - 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.