Released: Monday, 09 March 2026
What's new in 2026.1
These are the most important features you'll get by upgrading.
Octopus 2026.1
The 2026.1 release of Octopus Deploy offers faster recovery and greater flexibility and control.
This release’s noteworthy updates include:
- Diagnose issues and recover faster with the Recovery Agent
- Configure shared secrets in Process Templates in Platform Hub
- Better visibility and control with centralized retention policies
- Organize your instance at scale with improved tagging
- Iterate faster with copy releases
- More options for packages with NPM repository support
The 2026 Q1 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 2026.1.11242
Breaking Changes
- 9828 - Changes impacting Self-Hosted Octopus instances with no license key configured
- 9809 - Remove support for detecting us of .NET Full Framework in steps
- 9769 - Ensure auth tokens created while authenticated with a Token have an implicit expiry no later than the one utilized in the request
Other Changes
- 9909 - Added octopus variable to override NuGet source for dotnet scripts
- 9898 - Added the ability for administrators of self-hosted instances to enable exporting OpenTelemetry traces to disk for diagnostic purposes
- 9899 - Added a library of policy examples to the policy creation workflow
- 9894 - Extended claims for OIDC accounts to include namespaced claims
- 9871 - Missing package warning with dynamic packages and concatenation
- 9893 - Fixed bug where some Jira Service Management custom fields were not sending to jira with the correct type, resulting in errors
- 9889 - Enable Rego policy language syntax highlighting in code editor
- 9890 - Add new Argo CD step configuration to support triggering an Argo CD sync when an application is updated
- 9887 - The Recovery Agent can now read child deployment logs, providing accurate diagnostics when deployments using the Create a release step fail
- 9884 - Fix hanging on shutdown for misconfigured audit stream endpoint if there are pending messages
- 9883 - Fixed an issue where health checks failed for tenanted deployment targets
- 9882 - Octopus Server will now use the TLS protocol versions configured in the operating system. This will disable old TLS versions on modern systems
- 9881 - The git resource "Default Branch" on steps now supports fully qualified tag names
- 9876 - For the Package Cache, when the threshold for
cacheLowDiskSpaceThresholdorcacheDirectoryFullThresholdis reached, files that have been recently accessed will not be deleted. The Package Cache now supports--cachePackagesInactivityDays, which isDays of inactivity before eviction of cached packages. Default: 20. Additionally we no longer support--cachePackageswhich deleted from the cache based on creation age, instead that option sets--cachePackagesInactivityDays. If--cachePackageswas previously set it will be used as the value for--cachePackagesInactivityDays - 9877 - Add syntax highlighting for compliance policy Rego language in the code editor
- 9878 - Fix bug where a process template fails validation if it contains an Argo CD step that only creates a pull request for some environments
- 9873 - Package ids with successive special characters cause exception when uploading to build information
- 9880 - Added the Deployment Permissions Report page
- 9875 - Fixed an issue where a stale Argo CD application warning would be shown in the task logs when there was no stale applications
- 9874 - Added an option to select a specific version when creating or editing a process step based on a step-template
- 9868 - Improve reliability of cleaning up worker task lease records when completing a task execution
- 9862 - Added support for sensitive parameter default values in process templates
- 9870 - Prevent releases from being created if a used process template has missing parameter values
- 9836 - Fixed an issue where changing the Maximum Session Duration below default breaks Active Directory authentication
- 9867 - The Recovery Agent is now publicly available for self-hosted instances. No extra configuration is required. Please note: the agent communicates with foundational models through aiproxy.octopus.com, so this address needs to be reachable from your instance
- 9853 - Remove bulk deployment creation feature configuration. If this was disabled, deployments created from the UI with more than one tenant/environment will be created as a bulk deployment server task
- 9860 - Import Project file select option doesn't show the selected file
- 9869 - Add external feed support for NPM registries
- 9863 - No longer deploy to stale Argo CD Applications. Stale applications are ignored and a warning is logged during deployment
- 9857 - Upgrade Octopus Server to .NET 10
- 9859 - Add ability to limit web request body size
- 9856 - Kubernetes Live Object Status now shows a Stale status when data has not been received recently
- 9855 - Fix error in environment UI due to tag sets scope fetching
- 9845 - Package(s) Can't Be Found in Feed On Release Page when using OCI Registry Feed Type
- 9831 - Added telemetry on size of directories used by Octopus
- 9385 - Fix artifacts greater than 2GB failing deployments to offline drop targets
- 9846 - Update Microsoft.Data.SqlClient dependency to 6.1.4
- 9841 - Added support for additional SCIM filter expressions
- 9842 - Added ability to clone runbooks with tags
- 9838 - snapshots project id not matching up with the runbook project id
- 9610 - added option for replacing entries in .config files in "Deploy an Azure App Service" steps
- 9844 - Fix bug where default parameters aren't properly resolved when the same process template is referenced more than once in a deployment process
- 9825 - Fix issue where the default values file isn't updated if there are other files listed in the Argo CD Helm source
- 9837 - Sensitive variable values on the project variables page now correctly display as asterisks for users with view-only permissions instead of appearing empty
- 9833 - UI error when attempting to run non version controlled runbook in a version controlled project
- 9820 - Create a release based on a previous release
- 9822 - Fix deploy bicep template leaving unused Git Dependency
- 9827 - Add License Configuration in the Windows Octopus Manager
- 9806 - Fixed an issue where external NuGet feeds returned cached requests from the source instead of the latest available packages and versions
- 9824 - Project variables can be stored in both the database and version control, leading to duplicates on the Project Variables page
- 9793 - Fixed git-sourced packages from ADO repositories with spaces in the repository name not being found
- 9700 - Display runbook scoped variables on the Variable Preview page
- 9656 - Support child steps for Run a Script steps without target tags
- 9792 - Let users turn off the onboarding state on the Projects page
- 9821 - Fixed an issue where the code editor cursor would jump to the first line while editing large code blocks
- 9455 - Fix bug where unnecessary variable set snapshots are created
- 9819 - Improved manual intervention and guided failure buttons with clearer visual styling and more intuitive button ordering
- 9818 - Fix for importing existing library variable set
- 9816 - Fix issue where Kustomize and some Helm sources are displayed as Directory in the UI
- 9814 - Fix new release deployment triggers restricting deployments to environments belonging to the first phase of the associated lifecycle
- 9794 - Improved filtering and UX on the Users list screen
- 9812 - Conditionally emit the -no-color arg for terraform, based on the feature flag
- 9791 - Markdown support is missing from various tenant variables pages
- 9810 - Fix latest release deployment triggers restricting deployments to environments belonging to the first phase of the associated lifecycle
- 9807 - Added support for sensitive subscription webhook header value
- 9798 - Fixed bug with UI filtering for
aws-ecs-clustertargets - 9795 - Database statistics being out of date can affect query performance
- 9805 - Changing process template update behaviour no longer causes the page to jump/reload
- 9790 - Added the ability to set a default Powershell Edition in the global settings
- 9785 - Updated UI to display unscoped deployment freezes seperate from active freezes
- 9653 - Fixes long release names wrapping incorrectly in Live Status
- 9784 - Fix tenant tags and channel name not displaying on Project Dashboard with Kubernetes Live Object Status enabled
- 9781 - Introducing Octopus Recovery Agent. For application developers and devops engineers who are faced with a deployment failure, the Octopus Recovery Agent helps diagnose the root cause of deployment failure and provides intelligent steps to accelerate recovery
- 9646 - Lifecycle phase retention incorrectly marked as inherited
- 9778 - Upgrade Calamari to be built on .NET 8
- 9782 - Rename "Kubernetes Object Status" to "Step Verification"
- 9777 - Fixed react hook violation that broke deployment timeline button
- 9756 - Add default option to runbook retention
- 9768 - Added the ability to set a default Powershell Edition in the project settings
- 9770 - Task Log now correctly parses ANSI color codes
- 9771 - Project dashboard now shows Live Status environments in the same order as the default lifecycle
- 9753 - ConcurrencyTag variable not behaving as expected when scoped to runbook
- 9766 - IsActive property is not respected when creating new Users via the API
- 9762 - Upgrading Octopus Server's Autofac dependency from 8.4.0 to 9.0.0
- 9759 - Fixed a bug where saving in the Add Certificate drawer would always cause the page to be replaced with an error page
Unsure which version is a compatible upgrade? Compare releases.
Looking for older versions of Octopus? Download older versions.