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.8407 to 2023.1.8699

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.8407 to 2023.1.8699.

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.8407

  • 8004 - Fix load spreading for steps in a task