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.10863 to 2023.1.4670-hotfix.5433

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.

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.10863 to 2023.1.4670-hotfix.5433.

Changes in Octopus Server 2023.1.4670-hotfix.5433

  • 7965 - Fix issue preventing certificate tenant mode from being updated
  • 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.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 - Octopus no longer supports custom authentication extensions. Read the blog for more details: https://octopus.com/blog/deprecating-authentication-extensions
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.10863

  • 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