Released: Tuesday, 02 December 2025
What's new in 2025.4
These are the most important features you'll get by upgrading.
Octopus 2025.4
The 2025.4 release of Octopus Deploy offers safe scaling with built-in structure and governance, plus faster testing, and simpler GitOps deployments.
This release’s noteworthy updates include:
- Reduce duplication and improve CD pipeline consistency across teams with Process Templates in Platform Hub
- Make compliance visible, traceable, and automated with Policies in Platform Hub
- Faster, safer, and more cost-effective testing with Ephemeral Environments
- Simplify Argo CD deployment orchestration with Octopus - Early Access Preview
- Safer deployments with granular permissions for the Kubernetes agent
- Monitor and troubleshoot Kubernetes apps in one place with Live Object Status - now available for High Availability
The 2025 Q4 release is already available on Octopus Cloud and is now ready for download by our self-hosted customers.
Breaking changes
Release notes
Changes in Octopus Server 2025.4.10195
Changes in Octopus Server 2025.4.10186
Breaking Changes
- 9704 - Scope Helm image path annotations using Argo CD application source names
- 9701 - Remove distribution of Full Framework tooling dependencies in Octopus Server
- 9697 - Support project scoping per Argo CD application source
Other Changes
- 9764 - Updated Login to use OctopusHttpClientFactory to prevent Socket Exceptions
- 9763 - Fix bug where live status may show incorrect results if Gateway is deleted
- 9760 - Tenant variables now display correctly when configured as account parameters
- 9757 - Fixes issue where deleting a project would cause Ephemeral Environments page in other projects to fail to load
- 9748 - Enable session replay to help improve our user experience
- 9751 - Fixed display of step icons in process template preview for Firefox
- 9749 - Allow the tenant variables table to fit page width
- 9747 - Reduce size of compliance policy audit log
- 9702 - Updated certificate management commands in Octopus.exe CLI to allow managing the gRPC certificate using the
--typeparameter - 9746 - Fixed description markdown rendering in process templates preview
- 9745 - Policy file loading will now return the error message for an invalid Policy file
- 9741 - Allow users to write compliance policies based on the start trigger of a step
- 9742 - Added ability to override built in fields including summary with octopus variables
- 9734 - Add Public API Support for Policies
- 9743 - Removed breaking change from deployment and runbook process APIs when process templates are in use
- 9724 - Fixed an issue where release notes were missing for packages from external NuGet v3 feeds
- 9739 - Improved the Policy ocl file loading to exclude files without the .ocl file extension
- 9738 - Added error handling for ServerTask clean up concurrency exceptions
- 9736 - Remove the Not Specified option from the UI and only allow a policy Violation Action to be set with Block or Warning
- 9735 - Fixed the slug generation for a policy to not include invalid characters
- 9740 - Compliance policies written in Rego do not support user-defined functions
- 9723 - Updated modify trigger command to only reset last run time if the schedule actually changes
- 9727 - Compliance policies can be published and activated. Only published and active policies will be evaluated. Policy can have multiple published versions, but only one active version
- 9733 - Improve performance when creating releases that contain process template usages
- 9732 - Clear errors on select inputs when a valid value is provided
- 9731 - Fix an issue where an unshared process template would cause the deployment settings page to fail to load
- 9719 - Add a Policy creation workflow to the Platform Hub
- 9729 - Adding/removing package parameters from process templates breaks release versioning strategy
- 9728 - Process template package parameters can be saved without a package selected
- 9726 - Updated TentacleCertificateSignatureAlgorithm telemetry collector to handle null values
- 9722 - Fix issue where an Argo CD application doesn't show under deployment preview if its annotations are suffixed with the name
- 9720 - Fix issue where Argo CD image update & manifest steps fail if the target revision on the application source doesn't start with refs/heads/
- 9716 - Allowed process templates with names and filenames up to 255 characters to be shared and published
- 9718 - Update deferred packages to have null FeedId when exporting a step template
- 9717 - Add support for adding process templates to deployment processes via the API
- 9330 - Fixed an issue that left variable set snapshots orphaned
- 9577 - Updated modify runbook snapshot command to save git reference changes
- 9714 - Upgraded server to use the latest Octopus fork of the NuGet.Client packages, moving from version 3.6.0 to 6.14.1
- 9679 - NuGet Package Feed Search Fails on Release Page for Packages with a Pre-Release Tag that contains a Dot Character
- 9707 - Added the ability to edit a policy via the Octopus UI
- 9715 - Add support for adding process templates to runbook processes via the API
- 9713 - Fixed issue where the Argo CD application list fails to load when source repoUrl isn't an absolute Url
- 9712 - Add FilePathFilter property to Helm step
- 9708 - Updated Azure Calamari bundles to extract dotnet-script so C# scripts can run in Azure steps
- 9711 - Validate the destination environment has been selected when configuring a Deploy Latest Release to an Environment scheduled project trigger
- 9709 - Allow choosing which PowerShell to use when running PowerShell scripts from the Script Console
- 9706 - Self referencing exception unexpectedly throws when account expression cannot be resolved
- 9703 - Fixed an issue where workers are sometimes not released when accounts are not correctly setup up
- 9676 - Updated help text for Helm Template Values in the Deploy a Helm Chart step
- 9688 - Allow users to write compliance policies based on tenant, environment and project tags
- 9695 - Add support for managing process templates via the API
- 9699 - Fix importing custom step templates from a different space in process templates failing to load the step
- 9698 - ScriptCS has been fully deprecated and removed from the product
- 9391 - "Change Password" button no longer appears on users page if username/password authentication is disabled
- 9696 - Added a link for the Policies best practices documentation to the help sidebar for all policy pages
- 9639 - Add support for community step templates in process templates
- 9693 - Updated copy in Platform Hub
- 9694 - Extend tag sets to allow single-select and free-text as well as scoping to tenants, projects, and environments
- 9689 - Allow process template parameters to be marked as optional
- 9596 - Base64-encode the state parameter in OIDC authentication provider URLs
- 9683 - Introduces ability to preview process templates in step picker
- 9684 - Added support for adding parameters in-place while editing steps in a process template
- 9681 - Introduce more granular event categories for compliance policy evaluations
- 9680 - Fixed an issue where the task log link to an Argo CD Application was not correctly formatted
- 9672 - Added dialogs to select process template version and update behaviour
- 9678 - Added a new Policy details page in the Platform Hub
- 9677 - Add an option for the user to choose the compliance policy action, either 'block' or 'warn', with 'block' as the default if not specified
- 9662 - Configure and apply Kubernetes resources step doesn't allow variable usage in the volume name
- 9671 - Fix null reference exception with updating Lets Encrypt certificates
- 9666 - Fixed an issue where scoped users may encounter an error trying to view Argo CD Instances
- 9617 - Version controlled project settings page breaks when package name is changed if package release versioning is configured
- 9670 - When registering the monitor automatically, registration.serverAccessToken must be provided.
- 9667 - Add FilePathFilter property to kustomize step
- 9665 - Fixed error during migrator import affecting variable sets
- 7924 - New Feature: The default and maximum expiry periods for API keys can now be controlled by Octopus Administrators
- 9657 - Process Templates can now be added via step picker
- 9664 - Fixed an issue where the Argo CD instance Applications table would not page
- 9661 - Added new input data to policy evaluation to support the package and process git source for version-controlled projects
- 9638 - Allow selecting custom step templates from any visible space in process templates
- 9650 - Fixed process step time out of >=
1440minutes causing hung deployments - 9652 - Show tenant name in deployment timeline for tenanted deployments
- 9651 - Add an experimental endpoint
actiontemplates/search/v2which allows searching for action templates in multiple spaces - 9645 - Interrupted long running file transfers to Tentacle will now be retried so long as the tentacle appears to be online
- 9641 - Added a new action on the policies page to allow downloading all policy evaluation audit records
- 9637 - Fix process template icons not showing correctly
- 9640 - Add a loading indicator to the deployment timeline drawer panel
- 9623 - Released Process Templates as a Public Preview feature
- 9634 - Change Request details for ITSM providers are now available as variables in a deployment or runbook
- 9633 - Moved the manual intervention callout on the task page above the tabs, ensuring it's visible regardless of the tab selected
- 9628 - Fix not being able to select tenant variables for step template parameters that are account or certificate types
- 9625 - Fixed Terraform steps so they can be saved when Azure accounts are specified
- 9626 - Fix an issue where deployment previews could fail to load when multiple environments or tenants are selected for deployment
- 9621 - Fix for non-recurring future freezes blocking current deployments
- 9620 - Skip compliance policies evaluation without configured Platform Hub connection
- 9614 - OIDC Custom claims were not correctly evaluating variable expressions
- 9564 - Fix bug in git-enabled runbooks causing guided failure mode preferences to be ignored
- 9615 - Fixed an issue where Policy evaluation would fail to create audit records correctly with Runbooks stored in Git
- 9616 - Add an
Idproperty to account and certificate parameters in step and process templates - 9599 - Fix UI for Scheduled Deployment with Recurring Deployment Freeze
- 9581 - Fix issue with GCloud script step where the scripts are in a folder containing spaces
- 9603 - "false" displaying in tenant creation callout message
- 9594 - Fix issue navigating from runbook task log to the edit runbook step page
- 9600 - Show step names as missing resources in channel rules if they don't exist in the current deployment process
Unsure which version is a compatible upgrade? Compare releases.
Looking for older versions of Octopus? Download older versions.