Compare releases
Compare releases and check for compatibility between your existing Octopus Server and new releases.
What's new
These are the most important features you'll get by upgrading from 2025.1.9991 to 2025.3.839
Octopus 2025.3
No highlights for 2025.3
Octopus 2025.2
The 2025.2 release of Octopus Deploy helps you improve visibility into Kubernetes deployments, create repeatable processes for efficiency, and make compliance easier to manage at scale.
This release’s noteworthy updates include:
- Inspect Kubernetes manifests from within Octopus for improved observability
- Easily manage your Octopus instance with the Octopus Terraform Provider
- Scope common tenant variables to environments for simpler deployments at scale
- Additions and improvements to our Enterprise tier offering
- Configurable project-level deployment freezes for greater control over deployments
- Easily monitor license usage by adding it as an event type to your subscriptions
- More secure connectivity for external feeds with expanded support for OpenID Connect (OIDC)
The 2025 Q2 release is already available on Octopus Cloud and is now ready for download by our self-hosted customers.
Octopus 2025.1
The 2025.1 release of Octopus Deploy helps you deliver software faster and more flexibly, while making it simpler to manage your deployments.
This release’s noteworthy updates include:
- Work where you’re most productive with Config as Code for Runbooks
- Get greater flexibility and control by deactivating tenants that aren’t in use
- Easy and flexible connectivity with Generic Open ID Connect accounts
- Optimize resource use with child-first ordering of the task queue
- Improved encryption and algorithm support with TLS 1.3
The 2025 Q1 release is already available on Octopus Cloud and is now ready for download by our self-hosted customers.
Release notes
These are the features and fixes you'll get by upgrading from 2025.1.9991 to 2025.3.839.
Changes in Octopus Server 2025.3.839
- 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
- 9440 - Revert change that introduced bug that prevents editing a step that uses a worker pool variable
- 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
- 9433 - Artifactory Generic Feeds using OIDC and incorrectly displaying as the selected authentication method when selecting a Token
- 9435 - Adding ability to Manage API Keys in Configuration
- 9432 - Deselecting project when creating deployment freeze removes project from dialog altogether
- 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
- 9426 - Removing deployment target during deployment with large variable sets can have performance problems
- 9406 - Fix bug allowing steps to be created with blank worker pools
Changes in Octopus Server 2025.2.12568
- 9428 - Fix blank spaces not being stripped from script module filenames
- 9423 - Short network issues between Octopus and Tentacle can leave scripts executing on Tentacle, preventing further deployments on the tentacle.
- 9412 - Default to operations page in CaC projects with CaC Runbooks when there are only Runbooks (and no deployment process) in the project
- 9422 - Upgraded Autofac dependency to 8.3.0
Changes in Octopus Server 2025.2.12221
Changes in Octopus Server 2025.2.11861
Changes in Octopus Server 2025.2.11629
Breaking Changes
- 9409 - The
MachinePolicyId
property in deployment targets and workers will now return the default machine policy ID for the space if the given machine doesn't have aMachinePolicyId
set. This is a breaking change if you rely on the nullable behavior of theMachinePolicyId
property
Other Changes
- 9403 - Fix inconsistency between schedule times and timezones when viewing freeze schedules in countries that observe daylight savings
- 9416 - Revert the change that would return the default machine policy id from the create deployment target endpoint, as this led to extra permissions being required when modifying the deployment target
- 9324 - Underscore in a Script Module name will be stripped during deployment when loaded from source
- 9411 - Show exact branch and tag matches at the top of the list in the branch selector in Config as Code projects
- 9410 - Resilient Deployments not Raising Deployment/Runbook Run Started Event
- 9414 - Tenant common variables can now be scoped to environments
- 9405 - Filtering dashboard by multiple projects contains excess environments
- 9357 - Once step retries have been enabled, they cannot be disabled because backoff can't be set back to 'null'
Changes in Octopus Server 2025.2.10930
- 9378 - Send status update to Jira when a deployment is canceled
- 9401 - Build Information version matching has been updated to support versions with leading zeros
- 9400 - Improve audit events for variable sets
- 9399 - Fix environment link on lifecycle page to redirect to the environments page instead of infrastructure
- 9413 - Add support for concurrently writing to task logs in multi node setups.
- 9398 - Update step template usage table to only show relevant data for database backed projects
- 8801 - Fix step retry and timeout settings being reset when an associated step template is updated
- 9395 - Fix Azure script steps incorrectly defaulting to use Octopus bundled Azure tooling
- 9396 - Azure Bundled Tooling Still Used - Script Console with WebApp Targets
- 9397 - Azure Bundled Tooling Still Used - Custom Step Template using Run a Script Step against WebApp Target
- 9394 - Changing channels during release creation does not update missing packages
Changes in Octopus Server 2025.2.9747
- 9387 - Triggers are running for disabled projects
- 9393 - Fix agent selection on Kubernetes monitor upgrade dialog
- 9389 - Added support for using worker credentials to authenticate into AWS Elastic Container Registry feeds
- 9391 - "Change Password" button no longer appears on users page if username/password authentication is disabled
- 9390 - Display warning/error if Tentacle is using SHA-1
- 9373 - Fixed IIS Deployment Step failing when using PowerShell Core 7.3+
- 9360 - Helm Deployment Error when creating a Resource - 'Resource "
" not found' and 'Error reading JObject from JsonReader' - 9363 - Current Version shown in Deployment Preview one version behind current
- 9379 - Release preview not showing latest deployed release
- 8796 - Changed package name generation to produce shorter file names which reduce long path errors
Changes in Octopus Server 2025.2.9370
Changes in Octopus Server 2025.2.8689
- 9380 - Allow users to run Runbooks from the portal without VariableView permission
- 9375 - Fixed an issue where filtering server tasks by interruptions sometimes returned tasks that weren’t actually interrupted
- 9374 - Added the ability to compare changes in Kubernetes manifests between deployments
- 9381 - Fixed an issue where a Kubernetes manifest would be empty in the Applied Manifests view
- 9352 - Replaced the broken link with a functioning and more stable oc.to link. This link was also replaced with the working link in the docs in this pr.
- 9362 - Fix sample payload for project git conversion endpoint in Swagger UI
- 9377 - Fixed an issue that could cause Retention to fail with the error
Value cannot be null (Parameter 'dictionary')
. The cause is old deployment processes/releases with"Properties":null
in a PackageReference in the JSON
Changes in Octopus Server 2025.2.8076
- 9374 - Added the ability to compare changes in Kubernetes manifests between deployments
- 9372 - Fixed incorrect detection of package parameter when updating package references on a Run a Script step
- 9371 - Fixes bug that prevented KOS from failing a deployment early when a Kubernetes job with a Backoff limit of zero has failed
- 9346 - Add support for Change Controlled Runbooks
Changes in Octopus Server 2025.2.7821
Changes in Octopus Server 2025.2.7366
Changes in Octopus Server 2025.2.7176
Changes in Octopus Server 2025.2.6682
- 8798 - Fix missing step template usages for version-controlled projects
- 9343 - Added support for variable enumeration in bash using associative arrays. This uses the
octopus_parameters
field and requires the feature toggleBashParametersArrayFeatureToggle
to be enabled, bash version 4.2 or later and xxd on path - 9345 - Suppressed an error that caused deployments to fail when some Kubernetes manifests could not be parsed
- 9339 - Fixed issue when using Runbook Triggers with CaC Runbooks. When the trigger creates multiple runs, a failure to create one run would prevent the creation of the remaining runs for that trigger invocation
- 9334 - Added the ability to filter tasks by a tenant tag
- 9282 - Fixed the runbook 'Publish' button not showing correctly when editing a runbook process in some circumstances
- 9332 - Fixed incorrect current version being shown in deployment preview
- 9337 - Support version-controlled projects when exporting projects from Octopus
- 9335 - Handle Jira Server returning null values in issue search response
- 9325 - Fix child steps not respecting run conditions
- 9318 - Return correct Runbooks link on projects with Config as Code Runbooks
- 9297 - Fixed Force Package Download option not being respected on automatic deployments
Changes in Octopus Server 2025.2.5317
- 9331 - Fix no gap between Connectivity text and machine health status icon in the links sidebar on machines
- 9329 - Improved the design and UX of top-level pages for better consistency across the app
- 9328 - Fixed an issue where only up to 100 Jira work items could be retrieved; Fixed an issue where work items were being retrieved for all versions of packages
- 9325 - Fix child steps not respecting run conditions
Changes in Octopus Server 2025.2.4861
- 9327 - Fixed an issue where resetting a lost master key may fail due to missing Artifact folders
Changes in Octopus Server 2025.2.4621
Changes in Octopus Server 2025.2.3781
- 9314 - Fix Migrator CLI tenant variable lookup where source environment IDs do not match destination environment IDs
- 9316 - Fixed "Load more" button still being shown after loading all deployments in the release
- 9309 - Fixed missing DLL issue when using AAD username/password authentication for Azure Service Fabric
- 9313 - Fixed an issue where version controlled project variable pages weren't being displayed at full width
- 9297 - Fixed Force Package Download option not being respected on automatic deployments
- 9289 - Fixed an issue where editing variable sets on Tenants page redirected to a default space
- 9308 - Fixed an issue with the dashboard onboarding page showing no permissions when a user has scoped permissions assigned
Changes in Octopus Server 2025.2.3087
- 9308 - Fixed an issue with the dashboard onboarding page showing no permissions when a user has scoped permissions assigned
- 9311 - Fix regression that removed faded colour from older releases on the project dashboard
- 9309 - Fixed missing DLL issue when using AAD username/password authentication for Azure Service Fabric
- 9306 - Fixes issue where Operations page within a project would fail to load with
Sequence contains no matching element
error - 9302 - The Insights APIs are now officially supported and available. They can be used to create Insights reports as well as retrieve the metrics for projects and reports
- 9305 - Fix overriding existing project common tenant variable values when updating missing variables
- 9304 - Fix - unsaved changes lost when changing filters or variable set view options
- 9303 - Fix issue where Config as Code Runbooks were not using specified versions for packages after migration
- 9291 - Weekly and Monthly Recurring Deployment Freezes now activate correctly if times crosses date lines due to time zones
- 9296 - Update retention policy for tasks to clean up frequent server tasks
- 9287 - Helm feed urls no longer require trailing when downloading directly on targets
- 9274 - Support using OAuth 2.0 for authentication into Microsoft's SMTP Server using federation credentials
Changes in Octopus Server 2025.2.2026
- 9292 - Fixed bug where Runbook snapshots created before migrating to Config as Code Runbooks could not be deleted
- 9275 - Replaced Certificate Fails to Open
- 9290 - Migrate
Release
andRunbookSnapshot
table to include new field for process template references. Note: This change involves a database migration of releases which may take upwards of a few minutes. If you have many releases (over hundreds of thousands), we recommend more aggressive release retention settings for a quicker upgrade - 8734 - Runbook Parameters not shown for an unpublished runbook
Changes in Octopus Server 2025.2.1694
- 8262 - Custom authentication providers (Okta, AAD, etc) now work with virtual directories
- 8263 - Azure AD integration using a client secret does not work with Octopus bindings using a Virtual directory
- 9280 - Fixed bug allowing for duplicate tenant variable creation
- 9283 - Unscoped tenant common and project variables are returned as missing for all environments
- 9272 - Increased the space name and slug length limits to 50 characters
- 9269 - Recent feature usage telemetry data is included in the diagnostics data, if available
- 9271 - Add support for Runbooks in Config as Code
- 9267 - Validate that a Git HTTP URL ends with
.git
as some providers require it - 9258 - Fix for "unable to evaluate tokens" warnings appearing in task logs for Kubernetes steps
- 9268 - Updated validation on deployment freezes to allow terraform support
Changes in Octopus Server 2025.2.937
- 9266 - Revert "Update project dashboard interface"
- 9199 - Fixed an issue where intelligent log rendering would not show "show all" when log line count is between 70 & 120 lines
- 9264 - Improved resilience when creating Octopus Server config file
- 9263 - Fixed S3 External feed issue where the incorrect package version could be selected during deployment
- 9262 - Fix recurring deployment freeze schedule incorrectly reporting as active
- 9260 - Removed experimental message from ARM SSH targets and workers
- 9259 - Update project dashboard interface
- 9102 - Fixes issue where some old releases could not be edited due to
NullReferenceException
checking Git protection rules - 9257 - Docker images now use .NET 8.0.13
- 9251 - Fix rare scenario where Octopus Server may fail to start after upgrading due to a
DependencyResolutionException
- 9253 - Deploy a Release steps not providing skipped status when a release in an orchestration project is not connected the tenant
- 9243 - Fix authenticating against AWS EKS clusters using an AWS OIDC account
Changes in Octopus Server 2025.2.488
- 9247 - Fixed import/export for git-sourced deployment steps and step templates using git credentials
Changes in Octopus Server 2025.2.18
- 9252 - Release creation will now succeed even if Jira Username/Password are missing while Jira Integration is enabled
- 9244 - Update paging UX on project deployments page to match the Projects page. Improves rendering performance when a project has many channels
- 6475 - Enabled support for TLS 1.3 for Tentacle communications
- 9217 - Support debug mode
- 9243 - Fix authenticating against AWS EKS clusters using an AWS OIDC account
- 9149 - Removed
FeedArguments.Cache
property to improve Package Acquisition performance
Changes in Octopus Server 2025.1.10159
- 9432 - Deselecting project when creating deployment freeze removes project from dialog altogether
Changes in Octopus Server 2025.1.10150
- 9426 - Removing deployment target during deployment with large variable sets can have performance problems
Changes in Octopus Server 2025.1.10139
- 9419 - Updated OpenTelemetry to version
1.11.2
to fix CVE-2025-27513
Changes in Octopus Server 2025.1.10126
- 9405 - Filtering dashboard by multiple projects contains excess environments
Changes in Octopus Server 2025.1.10115
- 9394 - Changing channels during release creation does not update missing packages
Changes in Octopus Server 2025.1.10080
- 9380 - Allow users to run Runbooks from the portal without VariableView permission
Changes in Octopus Server 2025.1.10071
- 9377 - Fixed an issue that could cause Retention to fail with the error
Value cannot be null (Parameter 'dictionary')
. The cause is old deployment processes/releases with"Properties":null
in a PackageReference in the JSON - 9375 - Fixed an issue where filtering server tasks by interruptions sometimes returned tasks that weren’t actually interrupted
Changes in Octopus Server 2025.1.10012
Changes in Octopus Server 2025.1.10005
- 9335 - Handle Jira Server returning null values in issue search response
Changes in Octopus Server 2025.1.10002
Changes in Octopus Server 2025.1.9991
- 9327 - Fixed an issue where resetting a lost master key may fail due to missing Artifact folders