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
  • 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

Release notes

Changes in Octopus Server 2025.4.10195

  • 9767 - Fixes issue where provisioning of an ephemeral environment could not be retried if the provisioning runbook could not be run
  • 9765 - Deployment scheduler can be confusing around DST shifts

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 --type parameter
  • 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 >= 1440 minutes causing hung deployments
  • 9652 - Show tenant name in deployment timeline for tenanted deployments
  • 9651 - Add an experimental endpoint actiontemplates/search/v2 which 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 Id property 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.