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.3.11320 to 2022.4.9997

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.

Octopus 2022.3

As organizations continue to modernize, it's becoming increasingly important to ensure you can safely and reliably audit your CI/CD pipelines. You need to monitor and secure your deployments, and your teams need to scale reliably with tools to collaborate as releases move from deployment to testing and production.

This release adds support for version-controlled variables for version-controlled projects for a more complete implementation of the Config as Code solution we released in March. We also have several other new features to help you build safe, reliable, and auditable “As Code” CI/CD pipelines. These include ITSM change management with our ServiceNow and Jira Service Management integrations and built-in DevOps reporting.

This release’s noteworthy updates include:

  • Config as Code - version-controlled variables for version-controlled projects
  • ITSM - change management without friction for ServiceNow
  • Jira Service Management - efficient change management approvals (early access)
  • DevOps Insights - DORA insights to quantify value and improvements (early access)
  • GitHub Actions for Octopus Deploy v2
  • Simpler cloud target discovery setup

Together, these features support collaboration, scalability, and security for your deployments.

The 2022 Q3 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.3.11320 to 2022.4.9997.

Changes in Octopus Server 2022.4.9997

Changes in Octopus Server 2022.4.8736

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

  • 8126 - Fixes an issue with upstream DockerHub auth where tokens requested with "registry:catalog:" no longer grant access. Updated to use "registry:"
  • 8111 - Include all extension configurations in master key rotation

Changes in Octopus Server 2022.4.8583

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

  • 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

Changes in Octopus Server 2022.4.8572

  • 8098 - The refresh loop on the task details page now slows down if the refresh takes longer than 750ms

Changes in Octopus Server 2022.4.8555

  • 8103 - Fix blob error during master key rotation
  • 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 2022.4.8541

  • 8095 - Improved performance and prevent browser from locking up on the Release page, when the release contains thousands of variables
  • 8075 - Packages with chained file extensions (.tar.gz) are not being cleaned up from the Package Cache

Changes in Octopus Server 2022.4.8521

  • 7433 - Fixed daylight saving causing triggers to fire repeatedly

Changes in Octopus Server 2022.4.8517

  • 8081 - Fix to respond to HEAD requests on /api/octopusservernodes/ping

Changes in Octopus Server 2022.4.8505

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

  • 8063 - Decreased the number of queries to the project and lifecycle tables during retention
  • 8062 - EnvironmentIds, TenantIds and TenantTags are no longer required when modifying a certificate

Changes in Octopus Server 2022.4.8471

  • 8042 - Removed the list of variables that will be deleted on the Environment deletion confirmation screen

Changes in Octopus Server 2022.4.8470

  • 8056 - Docker repository search is more resilient to empty responses

Changes in Octopus Server 2022.4.8463

  • 8033 - Fixed High CPU during retention task due to query plan compilation
  • 8048 - Addressed an issue where some resources could be viewed when the user does not have access to the space
  • 8038 - Release retention no longer takes a long time to cancel when there are many projects

Changes in Octopus Server 2022.4.8454

  • 8034 - Release retention now makes better use of the available index
  • 8023 - Fixed an issue with Azure Service Fabric AAD referencing the ADAL .dll library instead of MSAL
  • 7993 - Fix message bus error when encountering old message format

Changes in Octopus Server 2022.4.8423

  • 8024 - Make environment summary search on partial name case-insensitive again

Changes in Octopus Server 2022.4.8421

  • 8027 - Fixed error that prevents releases created by previous versions of config-as-code to be deployed

Changes in Octopus Server 2022.4.8407

  • 8004 - Fix load spreading for steps in a task

Changes in Octopus Server 2022.4.8401

  • 8029 - Security fixes

Changes in Octopus Server 2022.4.8394

  • 8013 - Fixed an issue with the content security policy blocking custom step templates and various other things
  • 7999 - Swagger UI now loads correctly
  • 8012 - Fixed an issue where running the Deploy an Azure Web App (Web Deploy) step would fail when running in the Worker Tools

Changes in Octopus Server 2022.4.8377

  • 8012 - Fixed an issue where running the Deploy an Azure Web App (Web Deploy) step would fail when running in the Worker Tools

Changes in Octopus Server 2022.4.8373

  • 8002 - Removed a restriction that prevented deployments to older versions of Tentacle

Changes in Octopus Server 2022.4.8369

  • 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

Changes in Octopus Server 2022.4.8362

  • 7720 - When importing projects that have a library variable set attached you might get a duplicate entry for some variables

Changes in Octopus Server 2022.4.8344

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

Changes in Octopus Server 2022.4.8335

  • 7984 - Improve responsiveness and lower CPU usage when handling a large number of requests

Changes in Octopus Server 2022.4.8332

  • 7982 - Fixed an issue where the Authentication configuration could fail to load if a null value was present

Changes in Octopus Server 2022.4.8319

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
  • 7971 - Removed ConfigureServer permission requirement from Audit page
  • 7932 - Search no longer throws an exception when default space is enabled
  • 7965 - Fix issue preventing certificate tenant mode from being updated
  • 7774 - Fix error when creating scheduled trigger on Git project
  • 7956 - Fixed a timeout/compression bug between Octopus server and tentacle
  • 7952 - Lowering maximum session duration will no longer lock users out of logging in with OAuth
  • 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
  • 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
  • 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
  • 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
  • 7908 - Fix error when reading from Git projects with a trailing slash on the base path
  • 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
  • 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
  • 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.5100-hotfix.5915

  • 7830 - Fixed an issue where project settings for git projects could not be modified when no OCL existed on the default branch
  • 7826 - Improved the performance of the project summaries API endpoint

Changes in Octopus Server 2022.4.4911-hotfix.5910

  • 7830 - Fixed an issue where project settings for git projects could not be modified when no OCL existed on the default branch
  • 7826 - Improved the performance of the project summaries API endpoint

Changes in Octopus Server 2022.4.4600

  • 7833 - Make PUT /dashboardconfiguration restore default settings when called with no request payload instead of returning a "No request body" error message
  • 7827 - Fixed a problem where steps that use an Execution Container hosted on a private registry may fail if they come after a Manual Intervention step
  • 7818 - Support newer timezones, e.g. Europe/Kyiv
  • 7817 - Fixed an issue in the Process Editor where pressing enter while the Variable Picker is open unexpectedly triggers the Save or Commit action on the step
  • 7820 - Mark tinytype conversion as completed
  • 7777 - Scheduled triggers save correctly again
  • 7769 - Fix error running Runbooks in projects with prompted library variables

Changes in Octopus Server 2022.4.3912

  • 7866 - Reduced the payload size of project summaries, increasing the responsiveness of the portal
  • 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
  • 7809 - Fixed git ref selector disabling with invalid OCL
  • 7795 - Update message bus deserialization to fix message bus event pump related failures
  • 7803 - Unable to save issue tracking settings
  • 7773 - Git operations are slow on instances with a large number of machines
  • 7671 - Fix timeout when connecting projects to large Git repositories
  • 7784 - Fixed an issue where Octopus couldn't authenticate with git repositories hosted by Azure DevOps Server 2020
  • 7695 - Improved error message when git credentials are invalid or expired
  • 7807 - Fix issue with Octopus repeatedly attempting to connect to remote repositories after authentication failure
  • 7798 - Fix prompted variables inputs not showing for Runbooks in projects with Git variables
  • 7785 - Fixed long-running steps failures when using an Azure SQL database
  • 7796 - Fixed an issue where the GitCredentialView permission was required to invoke the /git/validate endpoint
  • 7805 - Improved the efficiency of some space-specific queries
  • 7813 - Fix memory leak in SQL reader cache
  • 7780 - Releases created by scheduled triggers are not considered for Insights Lead Time and are missing from the detail tables
  • 7779 - Fixed an issue where releases created by scheduled triggers were not audited
  • 7790 - Fix upgrade path from v2021.3.12912 and onwards to newer major versions
  • 7759 - OpenID Connect authentication providers can only be uninstalled by setting their environment variables
  • 7655 - Cloud Target Discovery has been updated so that all steps executing in Parallel which require Target Discovery, will have their discovery step scheduled in a parallel block before the parallel block of deployment steps
  • 7768 - Support for discovering Azure Functions Apps has been added
  • 7606 - Fixed Update All button in library step templates failing when template is used used by both git and database projects
  • 7778 - Fixed concurrent cache access
  • 7777 - Scheduled triggers save correctly again
  • 7776 - Fixed an issue with duplicate work item references being sent to Jira
  • 7604 - In addition to SemVer, package retention now also supports other version formats
  • 7772 - Fixed a problem where the Deploy Kubernetes Containers step may incorrectly report a successful deployment even though the a ConfigMap or Secret failed to be provisioned
  • 7748 - LDAP authentication provider can only be uninstalled by setting an environment variable
  • 7750 - Added slugs to Spaces, and added support for using them in the API routes
  • 7757 - Directory services authentication provider can only be uninstalled by setting an environment variable
  • 7804 - Fix issue where behavioural telemetry ingestion from the UI will cause key not present in dictionary errors
  • 7769 - Fix error running Runbooks in projects with prompted library variables
  • 7765 - Start Date now shows correctly again on the Project Trigger overview and when editing

Changes in Octopus Server 2022.4.2898-hotfix.3486

  • 7671 - Fix timeout when connecting projects to large Git repositories
  • 7695 - Improved error message when git credentials are invalid or expired
  • 7807 - Fix issue with Octopus repeatedly attempting to connect to remote repositories after authentication failure
  • 7796 - Fixed an issue where the GitCredentialView permission was required to invoke the /git/validate endpoint
  • 7798 - Fix prompted variables inputs not showing for Runbooks in projects with Git variables
  • 7795 - Update message bus deserialization to fix message bus event pump related failures
  • 7790 - Fix upgrade path from v2021.3.12912 and onwards to newer major versions
  • 7759 - OpenID Connect authentication providers can only be uninstalled by setting their environment variables
  • 7655 - Cloud Target Discovery has been updated so that all steps executing in Parallel which require Target Discovery, will have their discovery step scheduled in a parallel block before the parallel block of deployment steps
  • 7768 - Support for discovering Azure Functions Apps has been added
  • 7773 - Git operations are slow on instances with a large number of machines
  • 7784 - Fixed an issue where Octopus couldn't authenticate with git repositories hosted by Azure DevOps Server 2020
  • 7606 - Fixed Update All button in library step templates failing when template is used used by both git and database projects
  • 7778 - Fixed concurrent cache access
  • 7777 - Scheduled triggers save correctly again
  • 7776 - Fixed an issue with duplicate work item references being sent to Jira
  • 7604 - In addition to SemVer, package retention now also supports other version formats
  • 7772 - Fixed a problem where the Deploy Kubernetes Containers step may incorrectly report a successful deployment even though the a ConfigMap or Secret failed to be provisioned
  • 7748 - LDAP authentication provider can only be uninstalled by setting an environment variable
  • 7750 - Added slugs to Spaces, and added support for using them in the API routes
  • 7757 - Directory services authentication provider can only be uninstalled by setting an environment variable
  • 7804 - Fix issue where behavioural telemetry ingestion from the UI will cause key not present in dictionary errors
  • 7769 - Fix error running Runbooks in projects with prompted library variables
  • 7765 - Start Date now shows correctly again on the Project Trigger overview and when editing

Changes in Octopus Server 2022.4.1372-hotfix.2252

  • 7777 - Scheduled triggers save correctly again

Changes in Octopus Server 2022.4.1372-hotfix.1838

  • 7769 - Fix error running Runbooks in projects with prompted library variables
  • 7765 - Start Date now shows correctly again on the Project Trigger overview and when editing

Changes in Octopus Server 2022.4.1372-hotfix.1656

  • 7769 - Fix error running Runbooks in projects with prompted library variables

Changes in Octopus Server 2022.4.1371

Breaking Changes
  • 7760 - Updated ServiceNow approval caching. This results in existing Change-controlled deployments being unable to exit "Queued" state; these will need to be canceled and restarted
  • 7755 - Fixes an issue with the "Create Release" page for projects that rely on an image from a DockerHub (<https://index.docker.io>) feed
Other Changes
  • 7763 - Fixed an issue whereby deployments which reference Jira Work Item(s) (using the Jira Integration) and contain a Manual Intervention step would fail, reporting an AutoFac circular dependency
  • 7758 - Fixed an issue where git migrations may incorrectly get skipped
  • 7747 - Username Password authentication provider can only be uninstalled by setting an environment variable
  • 7557 - Fix cancelling long-running script tasks on Linux Tentacles/Workers
  • 5643 - Out of date Tentacle and Calamari warnings are no longer useful
  • 7735 - Fixed an issue where duplicate slugs were allowed in deployment and runbook processes
  • 7728 - Fixed an issue where tenant certificates were not being exported
  • 7740 - Project triggers no longer generate modified audit events without user input

Changes in Octopus Server 2022.4.791

Breaking Changes
  • 7738 - Guest authentication provider can only be uninstalled by setting an environment variable
Other Changes
  • 7332 - Attempting to save a Form without a selected Account fails validation but the Combo Box does not show as red
  • 7331 - Fixed ECS Cluster Deployment Target so it only enables the save button after data is entered
  • 7746 - API deployments/create/untenanted/v1 fails to deploy release in a version controlled project
  • 7737 - Adding a deployment target will once again ensure that linked environments, machine policies, and tenants exist in the system when using the API
  • 7743 - Ensure rolling deployments happen in correct order based on targets
  • 7742 - Fix an issue where branches created via the branch selector would end up prefixed with refs/heads/
  • 7474 - Fix styling around the load all button
  • 7717 - Fix deployment creation page using incorrect git ref for deployment settings
  • 7373 - Fix clickable area in user identity search list
  • 7680 - Allow delete dialogs to be submitted using the enter key
  • 7445 - Fix navigation bar overflow menu not appearing on smaller screen widths
  • 7696 - Added "machine task processing limit" to the Upgrades settings to allow processing more machines in upgrade and health check tasks at any given time
  • 7734 - Fixed upgrade error when there is a release with a large number in the version
  • 7733 - Fixed deserialization of dates
  • 7721 - Fix Entity Not Found error on Project pages for Projects with unicode character names
  • 7545 - Fixed issue with Unicode in project names
  • 7705 - Connections to machines without a proxy are closed when the machine is deleted
  • 7723 - Make automatic release creation more performant for instances with a large number of projects

Changes in Octopus Server 2022.3.11320

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