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 2022.4.9997 to 2023.1.11831

Octopus 2023.1

The release of Octopus 2023.1 has new features to help improve your experience, including:

  • Helm chart for installing Octopus server into a Kubernetes cluster
  • Faster tentacle upgrades
  • Improvements to the ‘Deploy Kubernetes containers’ step
  • Improving Deployment Experience for Enterprise and Cloud Users for faster, more efficient deployments and better usability
  • Performance improvements for version controlled projects

The release is available on Octopus Cloud and ready for download by our self-hosted customers.

Octopus 2022.4

As organizations innovate and scale, DevOps teams deal with complex deployments that demand best-in-breed solutions. Whether delivering containers and microservices or trusted legacy applications, every team faces its own challenges.

Octopus Deploy orchestrates and automates complex deployments, wherever you are in your modernization journey. And we're constantly improving your deployment experience with new features that create happy deployments. The enhancements in this release improve your team's deployment experience from the command-line to our roadmap.

This release's noteworthy updates include:

  • Octopus CLI vNext
  • Config as Code: built-in branch protection support
  • Octopus Deploy interactive roadmap
  • Power up your audit log with control feeds
  • Easier onboarding for teams
  • Work better together with integration updates
    • ITSM Change Management - Jira Service Management support (GA)
    • Improved Hashicorp integration with Terraform Provider for Octopus Deploy 0.9 and Vault Integration
  • Product improvements
    • Simple Master Key Rotation
    • Updates to the task queue to provide richer summaries
    • Improved performance and reliability in the Octopus portal

The 2022 Q4 release is available on Octopus Cloud and ready for download by our self-hosted customers.

Release notes

These are the features and fixes you'll get by upgrading from 2022.4.9997 to 2023.1.11831.

Changes in Octopus Server 2023.1.11831

  • 8249 - Octopus Server on Linux will no longer attempt to run HTTP.sys in extensions
  • 8242 - Improved performance of deployment preview

Changes in Octopus Server 2023.1.11487

  • 8218 - Add variable Octopus.Deployment.WorkerLeaseCap to manage worker lease cap

Changes in Octopus Server 2023.1.11313

Changes in Octopus Server 2023.1.11066

  • 8184 - Improved response time when requesting projects by slug
  • 8185 - Fixed a regression that was causing stale worker leases when tasks were cancelled

Changes in Octopus Server 2023.1.10950

  • 8125 - Fixed cloning project issue caused by permission scoping
  • 8080 - Users with the required permissions to clone a project scoped to a specific project group receive a permission warning when cloning a project

Changes in Octopus Server 2023.1.10766

  • 8118 - Connectivity checks running indefinitely blocking execution on a deployment target
  • 8161 - Fixed package acquisition with multiple workers and multiple package references when lease cap is enabled

Changes in Octopus Server 2023.1.10475

  • 8129 - Fixing UserId filtering for audit logs

Changes in Octopus Server 2023.1.10235

  • 8052 - Unique name constraint error when cloning a project

Changes in Octopus Server 2023.1.10229

  • 8138 - Resolving Manual Interventions and Guided Failure as well as viewing blocking deployments is now much faster when there are a large number of interventions or guided failures

Changes in Octopus Server 2023.1.10072

  • 8134 - Retention policies are no longer run simultaneously to reduce contention on the database

Changes in Octopus Server 2023.1.10046

  • 8131 - Fixed a permission scoping issue affecting docker container registries, causing image search and tag search to fail impacting release creation

Changes in Octopus Server 2023.1.9909

  • 8127 - Fixed error if TrustedProxies contains invalid values

Changes in Octopus Server 2023.1.9886

  • 8126 - Fixes an issue with upstream DockerHub auth where tokens requested with "registry:catalog:" no longer grant access. Updated to use "registry:"

Changes in Octopus Server 2023.1.9882

  • 8126 - Fixes an issue with upstream DockerHub auth where tokens requested with "registry:catalog:" no longer grant access. Updated to use "registry:"

Changes in Octopus Server 2023.1.9879

  • 8002 - Removed a restriction that prevented deployments to older versions of Tentacle
  • 8111 - Include all extension configurations in master key rotation

Changes in Octopus Server 2023.1.9794

  • 7647 - Fixed an issue where a long-running database transaction would grow the transaction log unreasonably large during a long deployment

Changes in Octopus Server 2023.1.9791

  • 8112 - fix for tenants endpoint missing Page.Next hypermedia link when more than one page of results

Changes in Octopus Server 2023.1.9788

  • 8113 - Improved rendering performance and responsiveness of the Dashboard page when there are many projects, environments and tenants in use
  • 8110 - Improved performance of the interruptions list API
  • 8098 - The refresh loop on the task details page now slows down if the refresh takes longer than 750ms

Changes in Octopus Server 2023.1.9781

  • 8103 - Fix blob error during master key rotation

Changes in Octopus Server 2023.1.9767

  • 8100 - Improve performance and prevent lock-ups of Octopus Server Portal on pages that display variables when there are thousands to display (eg Release page)
  • 8095 - Improved performance and prevent browser from locking up on the Release page, when the release contains thousands of variables

Changes in Octopus Server 2023.1.9760

  • 8091 - Fix modify project endpoint not picking up project id properly

Changes in Octopus Server 2023.1.9749

  • 8095 - Improved performance and prevent browser from locking up on the Release page, when the release contains thousands of variables

Changes in Octopus Server 2023.1.9732

  • 8092 - Windows Tentacle upgrade now correctly checks for the net48 runtime

Changes in Octopus Server 2023.1.9727

  • 8075 - Packages with chained file extensions (.tar.gz) are not being cleaned up from the Package Cache

Changes in Octopus Server 2023.1.9722

  • 7433 - Fixed daylight saving causing triggers to fire repeatedly

Changes in Octopus Server 2023.1.9720

  • 8084 - Fixed an issue when saving web portal configuration using OctopusClient which caused authentication configuration to be overridden

Changes in Octopus Server 2023.1.9716

  • 8079 - Improved the performance of the list deployments API when there is large build information
  • 8081 - Fix to respond to HEAD requests on /api/octopusservernodes/ping

Changes in Octopus Server 2023.1.9692

  • 8073 - Fixed an issue with X-Forwarded-For headers that included ports

Changes in Octopus Server 2023.1.9687

  • 8070 - Improved performance of "missing variables" indicators on the Tenants page when there are thousands of tenants that have missing variables

Changes in Octopus Server 2023.1.9680

  • 8063 - Decreased the number of queries to the project and lifecycle tables during retention

Changes in Octopus Server 2023.1.9672

  • 8062 - EnvironmentIds, TenantIds and TenantTags are no longer required when modifying a certificate
  • 8042 - Removed the list of variables that will be deleted on the Environment deletion confirmation screen
  • 8056 - Docker repository search is more resilient to empty responses
  • 8033 - Fixed High CPU during retention task due to query plan compilation
  • 7478 - SSH home paths are unique per SSH target or worker rather than per HA node
  • 7944 - Terminate child processes on Linux targets and Workers when a server task is cancelled
  • 8039 - Added deployment duration chart to the Insights feature
  • 7988 - Fixed Insights Report creation validation error TenantMode is required
  • 8069 - Improved the usability and performance of the Tenant Overview page when choosing to "load all" tenants, for customers with thousands of tenants
  • 8048 - Addressed an issue where some resources could be viewed when the user does not have access to the space
  • 7881 - Task incorrectly reporting earlier versions of package on tentacle
  • 8038 - Release retention no longer takes a long time to cancel when there are many projects
  • 8036 - Fixed a recent regression in the time taken for policies to be loaded during release retention
  • 8035 - Improved the log output of the retention task
  • 8023 - Fixed an issue with Azure Service Fabric AAD referencing the ADAL .dll library instead of MSAL
  • 8034 - Release retention now makes better use of the available index
  • 7993 - Fix message bus error when encountering old message format
  • 8024 - Make environment summary search on partial name case-insensitive again
  • 7970 - Minor UI - Deploy CloudFormation Step Template - Configuring S3 Source Gives "Template Source Not Specified"
  • 7943 - AWS S3 Bucket Feed doesn't show in feed selection dropdown in Deploy a Package steps
  • 8027 - Fixed error that prevents releases created by previous versions of config-as-code to be deployed

Changes in Octopus Server 2023.1.8699

  • 8021 - /nuget/packages endpoint no longer handles trailing slashes after query parameters
  • 8022 - Improve performance for Git projects connected to repositories with a large number of branches and tags
  • 7814 - Fix step template updating on Git projects when there are pending Git migrations
  • 8004 - Fix load spreading for steps in a task
  • 7981 - fixes issue where project triggers would run immediately after modification
  • 8029 - Security fixes
  • 8014 - Index rebuilding is no longer happening during an upgrade
  • 8013 - Fixed an issue with the content security policy blocking custom step templates and various other things
  • 8011 - Fixed an issue loading Runbooks whose names contained certain characters
  • 7999 - Swagger UI now loads correctly
  • 8059 - Tentacle upgrades are performed on more machines at once, reducing the overall time it takes to upgrade many Tentacles
  • 8012 - Fixed an issue where running the Deploy an Azure Web App (Web Deploy) step would fail when running in the Worker Tools
  • 8003 - Fixed an issue where the Community Template Sync task could fail if an installed Template's underlying data needed updating to be in-sync with the published version
  • 6952 - Prevent tag deletions if they are used in runbook processes
  • 5015 - Show a warning that scoped variables will be deleted when deleting channels and deployment targets
  • 8002 - Removed a restriction that prevented deployments to older versions of Tentacle

Changes in Octopus Server 2023.1.7294

  • 7720 - When importing projects that have a library variable set attached you might get a duplicate entry for some variables
  • 7811 - Fix channel create and edit page on Git projects when the current branch has an invalid deployment process
  • 7822 - Fix loading variable-bound packages when creating releases in Git projects
  • 7997 - Fix modifying project group name/description
  • 7821 - ECS Step Template - Unable to specify FirelensConfiguration in Container Definition
  • 7751 - Fixed autocomplete popup not showing in the fullscreen code editor

Changes in Octopus Server 2023.1.6794

  • 7929 - Validate Git repository is valid URL when updating settings for a project

Changes in Octopus Server 2023.1.6715

Breaking Changes
  • 7983 - Update action templates logo endpoint to return not found response when the logo is not found
  • 8074 - Tentacle on Windows now requires .NET Framework 4.8
Other Changes
  • 7995 - Fixes issue where updating to a new major version of a step would result in unexpected null values in step inputs
  • 7328 - Resolved Temp/NugetTemp cache folder retaining packages after tentacle package acquisition
  • 7992 - Adding handling for invalid certificate exceptions and will continue to process other certificate expiries
  • 7783 - Fix duplicate slug error when cloning steps in the process editor
  • 7789 - Fix issue when converting a project to Git using an existing Octopus configuration folder
  • 7981 - fixes issue where project triggers would run immediately after modification
  • 7982 - Fixed an issue where the Authentication configuration could fail to load if a null value was present
  • 7984 - Improve responsiveness and lower CPU usage when handling a large number of requests
  • 7979 - Fixed workerpools endpoint in /api doc
  • 7676 - Fixed an issue where you could clone a runbook with an empty name
  • 7977 - Fix event type when machine is deleted by machine policy
  • 7978 - Certificate metadata corrected to allow expiry and warnings to be properly raised
  • 7971 - Removed ConfigureServer permission requirement from Audit page
  • 7932 - Search no longer throws an exception when default space is enabled
  • 7845 - The Deployment History section will now be refreshed when the variables are updated for a Release
  • 7436 - Fixed task log delays for logs from a long-running process
  • 7962 - Improve Tentacle free disk space checks to take into account mount points
  • 7953 - Fixed an issue where telemetry would fail to send when hosting server in a virtual directory
  • 7792 - Releases created on version controlled projects before conversion will fallback to using the deployment settings from the default branch on the preview screen
  • 6518 - Fixed and issue where certain packages in the built in package repository could not be viewed
  • 7969 - Fixed empty audit messages being generated for workers when doing health checks
  • 7965 - Fix issue preventing certificate tenant mode from being updated
  • 7960 - Fix an issue where the deployments page did not show an error message in some circumstances when the deployment has been deleted
  • 7608 - Provide a clearer error message when trying to save a tenant tag set without a name
  • 7529 - Fixed the issue that variables selection button retains focus after a variable is selected
  • 6932 - Usage not displayed for Accounts set to a variable in a variable set that is part of a release which blocks Account deletion
  • 7366 - Added support to define Host Aliases in the Deploy Kubernetes Containers step
  • 7774 - Fix error when creating scheduled trigger on Git project
  • 7086 - Fixed the Swagger UI to work when Octopus is configured to use a virtual directory

Changes in Octopus Server 2023.1.4362

Breaking Changes
  • 7867 - Update built in package API endpoint api/{spaceId}/packages/{raw} to return not found response if package is not found
  • 7859 - The packages/{id} endpoint will now return a bad request response when an invalid package id is provided
Other Changes
  • 7956 - Fixed a timeout/compression bug between Octopus server and tentacle
  • 7955 - Fixed runbook run list display so that it is consistent between pages
  • 7952 - Lowering maximum session duration will no longer lock users out of logging in with OAuth
  • 7897 - ServerTaskStartedDomainEvent not published for deployment tasks.
  • 7489 - Swagger UI missing the body for POST'ing to the /users/ endpoints.
  • 7766 - Failed automatic deployments from lifecycle promotion will no longer create empty server tasks
  • 6845 - Steps with a Variable Run Condition evaluating as "false" presents a Status.Code of "Succeeded" instead of "Skipped"
  • 7940 - Fixed an issue where validation during running a runbook could incorrectly think there were duplicate runbook names
  • 7950 - Reduce the number of API calls made when rendering lifecycle previews
  • 4625 - Allow release versions up to 349 characters
  • 7939 - Fixed a potential issue when fetching git documents
  • 7947 - To enable customers running Octopus behind a proxy to send logs to Seq we now send default proxy credentials as part of the HTTP request to Seq
  • 7931 - Hanging SFTP file operations prevent a user successfully canceling a task
  • 7927 - Fixed incorrect Json serialization casing in the execution API responses
  • 7941 - Build VCS details exposed to release notes via Octopus.Release.Builds variable
  • 7936 - Fixed a conflict issue when concurrently updating multiple channels
  • 7621 - Added a warning during deployment for GKE customers if their deployment requires the gke-gcloud-auth-plugin to be available
  • 7901 - Fixed an issue where Github Container Registry Docker feeds time out when searching images, or creating releases that depend on GHCR images
  • 7921 - Cancelled Tasks (e.g. a deployment) completes but the Task is never marked as completed and stays in the cancelling state with SQL Error 1222.
  • 7920 - Cancelling now works in HA setups
  • 7925 - Stopped a canceling server task from being deleted until it has finished canceling
  • 7872 - Make default API key expiry 6 months instead of never
  • 7937 - Interaction with git resources takes place directly via the index rather than creating worktrees
  • 8030 - Improve performance for Git projects connected to repositories with large working directories
  • 7896 - The Octopus portal will correctly resolve routes when hosted in a virtual directory
  • 7916 - Repaired the connection between users and external authentication providers
  • 7904 - Target discovery and AWS steps can now inherit web identities such as those associated with service accounts in EKS pods
  • 7377 - Harden-InstallationDirectory.ps1 is now signed
  • 7874 - Improved internal caching, resulting in health checks over thousands of machines running closer to how long they used to
  • 7907 - Fix package details error when id contains metadata
  • 7905 - Fixes the display type of space search results to not be an internal type
  • 7908 - Fix error when reading from Git projects with a trailing slash on the base path
  • 4741 - Return a more helpful error message when failing to download packages from a file system NuGet feed
  • 7862 - Runbook publish status not reflected immediately after publish
  • 7900 - Improved log message when failing to pump from the message bus
  • 7894 - Clicking "Run" after modifying a Runbook process without saving and then accepting the changes makes the "Run" button vanish.
  • 7828 - Fix regression to allow selection of package acquisition location on external feeds
  • 7898 - Fixed an import issue when the import directory did not exist
  • 7654 - Fixed a bug where clicking on a scheduled trigger hyperlink on the audit page would cause a React error
  • 7893 - Fixed an issue where package build information was incorrectly calculated resulting in failures to create releases and view packages from the built in feed
  • 7880 - Indicate when subsequent child steps are skipped
  • 7889 - Updates feed packages search endpoint to return a 500 when docker feed cannot be searched instead of a misleading 404
  • 7878 - Fix variables names not populating in worker pool dropdown for projects with Git variables
  • 7877 - Fixed the Linux Octopus.Migrator binary file references that are used on MigrationImportTaskController and MigrationPartialExportTaskController
  • 7879 - More information will be logged when a task is canceled because the node went offline
  • 7885 - For Git projects, fix Input string was not in a correct format error being returned remote Git repositories return an error message containing a { or }
  • 7370 - Fix error message when deleting environment with scoped accounts
  • 7851 - Fix Azure account variables names not being populated in dropdowns for Git projects
  • 7788 - Fix AWS account variables names not being populated in dropdowns for Git projects
  • 7876 - Improved the load time of the project summary screen
  • 7873 - Fixes the "ISpacePartition has not been registered" error when using the Migrator CLI
  • 7413 - AWS EKS Targets - IAM Authenticator v0.5.4+ no longer supports v1alpha1 endpoint
  • 7856 - Correctly detect OS of Amazon Linux machines and improve the upgrade flow for machines with an unknown OS
  • 7864 - Fixed a memory spike when uploading delta packages using octo diff
  • 7865 - Performance improvement for the dashboards
  • 7870 - Support master key rotation
  • 7816 - Package retention no longer attempts to run on raw scripting targets
  • 7857 - Disable new Tentacle upgrade flow
  • 7838 - Improved the load time of the Create Deployment screen
  • 7855 - Removed redundant second health check when a new worker is created
  • 7844 - Fixed issue with Jira integration incorrectly assuming dates might be Jira work items
  • 7848 - Fixed an issue where a transient database connection issue could persist even after the transient issue has gone
  • 7853 - Octopus just keeps getting better and better!
  • 7812 - The Lead Time now shows the values on the days in the lead up to the deployment not just on the day it occured
  • 7744 - Stale package locks are now appropriately released
  • 7604 - In addition to SemVer, package retention now also supports other version formats
  • 7787 - Add logging around worker lease cap
  • 7942 - Fixed an issue where the internal message bus may cause long-running transactions and excessive SQL queries when running Octopus Server in a multi-node cluster
  • 7790 - Fix upgrade path from v2021.3.12912 and onwards to newer major versions

Changes in Octopus Server 2022.4.9997