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 2024.1.12890 to 2024.3.4762

Octopus 2024.3

No highlights for 2024.3

Octopus 2024.2

The 2024.2 release of Octopus Deploy has updates to further improve our Kubernetes functionality and simplify deployments and operations.

This release’s noteworthy updates include:

  • Simpler deployments to Kubernetes with the Kubernetes agent
  • External feed triggers for Kubernetes for automated releases
  • Improved visibility and management of variables for tenanted deployments
  • ServiceNow integration improvements to provide greater control of change requests
  • Better visibility of key account information with the license usage dashboard
  • Performance improvements for a faster task queue
  • Additional performance improvements
    • Support for Windows 10 LTSC
    • SSH.NET Library upgrade with SHA 256 support

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

Octopus 2024.1

The 2024.1 release of Octopus Deploy has updates to make your deployments simpler to manage and more secure and efficient.

This release’s noteworthy updates include:

  • More secure connectivity to AWS using OpenID Connect (OIDC)
  • Artifactory Generic Repositories now supported in Octopus
  • Faster feedback loops with inline execution containers
  • Improved performance with Octopus Server upgraded to .NET 8
  • Building on Resilient Tentacle Communications
  • Improved page layouts for easier navigation

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

Breaking changes

Workers and Targets Running Windows Server 2003 and unpatched Windows Server 2008 Operating Systems will no longer be functional

Recent updates to our execution engine necessitate the minimal requirement of .NET 4.6.2 on Windows Targets and Workers. Due to the support capabilities of the .NET Framework, this requirement excludes Windows 2003 Servers, and Windows 2008 Servers that do not have the latest service patches installed.

Learn more about this change in the GitHub issue.

Release notes

These are the features and fixes you'll get by upgrading from 2024.1.12890 to 2024.3.4762.

Changes in Octopus Server 2024.3.4762

  • 8881 - Log HTTP 500 errors correctly in the web request logging file

Changes in Octopus Server 2024.3.4152

  • 8842 - Fixed an issue preventing Tentacle upgrades on Linux initiated by Octopus Server from falling back to using an archive file for installation if yum or apt-get fails/is unavailable
  • 8878 - Added indentation markers to the code editor for when editing YAML. Fixed a small bug in the code editor, where the editor will now remain focused when you drag select outside of the editor region
  • 8871 - Migrate DeploymentSettings table to use Entity Framework
  • 8876 - Fix issue where health checks on Cloud Regions fail
  • 8880 - Align fonts on project variables and tenant variables to be 14px monospaced. Improve some styling on the tenant variables page
  • 8832 - Improves help text for Deploy a CloudFormation Template step so that it doesn't imply that only JSON templates are supported
  • 8877 - Convert ProjectTriggerExecution to Entity Framework
  • 8864 - Migrate Lifecycle table to use Entity Framework
  • 8873 - Convert DeploymentCompletion to Entity Framework
  • 8866 - Migrate Feed to use Entity Framework
  • 8868 - Fixed UI performance regression on variable edit page
  • 8867 - Large Variables page with lots of scopes is slow to add new value
  • 8872 - Migrate AutoDeployQueueItem to use Entity Framework
  • 8874 - Created new experimental optimization for the data source of the new Projects page
  • 8727 - Fixed an issue where async zip deploy failed to clean up packages resulting in failed tasks

Changes in Octopus Server 2024.3.3636

  • 8855 - Convert InsightsReport to use Entity Framework
  • 8870 - Upgrade CodeMirror from v5 to v6 and apply new code editor theme for better syntax highlighting
  • 8865 - Don't map work items in build information on pages that don't show this information
  • 8861 - Convert MessageBusCursor and MessageBusEvent to Entity Framework
  • 8863 - Converted DeploymentFreezeOverride document persistence from JSON store to relational model
  • 8841 - Ensure SQL connections are closed when encountering exceptions during disposal
  • 8844 - Migrate CommunityActionTemplate table to use Entity Framework
  • 8850 - Migrate LibraryVariableSet table to use Entity Framework
  • 8860 - Removes start delay for Polling Tentacles https://github.com/OctopusDeploy/Issues/issues/8860
  • 8857 - Fixed an issue where certificate metadata validation returns a byte array and throws an exception when using non string inputs like otherName.1 = 1.3.6.1.4.1.111.20.2.3;UTF8:<mailto:0111111111@test.gov|0111111111@test.gov>
  • 8853 - Audit event for non-scheduled deployments should indicate it was immediately deployed

Changes in Octopus Server 2024.3.3075

  • 8836 - Migrate GitCredential table to use Entity Framework
  • 8854 - Improved performance of account usage across variable snapshots

Changes in Octopus Server 2024.3.2716

  • 8852 - Added "Edit" deeplinks to Process steps in Runbook logs
  • 8851 - Migrate DataMigrationState table to use Entity Framework
  • 8847 - Converted DashboardConfiguration document persistence from JSON store to relational model
  • 8849 - Enable new Project Tenant Variables view by default
  • 8819 - Migrate WorkerTaskLease table to use Entity Framework
  • 8841 - Ensure SQL connections are closed when encountering exceptions during disposal
  • 8824 - Migrate Space table to use Entity Framework
  • 8821 - Migrate MachinePolicy table to use Entity Framework

Changes in Octopus Server 2024.3.2222

  • 8727 - Fixed an issue where async zip deploy failed to clean up packages resulting in failed tasks
  • 8845 - Deleting projects or environments removes them from deployment freeze scope
  • 8839 - Fixed a duplicate key exception when building telemetry information
  • 8843 - Fixed Add Worker page defaulting to non-existent Kubernetes category
  • 8831 - Converted Subscription document persistence from JSON store to relational model
  • 8834 - Migrate ConnectProjectToTenantsTask table to use Entity Framework

Changes in Octopus Server 2024.3.1881

  • 8792 - Improve Git persistence logic to better detect and recover from corrupt repositories
  • 8837 - Converted DatabaseMaintenance document persistence from JSON store to relational model
  • 8835 - Deprecation of Helm V2 support
  • 8833 - Stopped auditing document modifications for newly queued tasks
  • 8826 - Fixed an issue where very large packages (4+ GB) failed to download from an external feed
  • 8064 - Correctly set windowsFxVersion when deploying containers to a Windows-based container Azure Web App
  • 8827 - Add automatic retry when acquiring packages/containers from Docker, OCI Helm and Artifactory feeds
  • 8818 - Octopus RestAPI create release unable to include / in package name
  • 282 - Create Release --package=VALUE - Unable to include / in package name in value
  • 8823 - Converted Proxy document persistence from JSON store to relational model
  • 8443 - Added the ability to edit the Project Lifecycle from the Project Settings page
  • 8820 - Missing Jira work items will not block release creation
  • 8816 - Converted OctopusServerNodeStatus document persistence from JSON store to relational model
  • 8799 - Upgraded BouncyCastle.Cryptography dependency from 2.2.1 to 2.3.1

Changes in Octopus Server 2024.3.1025

  • 8808 - Migrate DynamicInfrastructureLifecycle table to use Entity Framework
  • 8803 - Migrate ProjectIntents table to use Entity Framework
  • 8815 - Rename Library to Git Credentials in Git Repository authentication selector
  • 8812 - Migrate KubernetesTaskResourceStatus table to use Entity Framework
  • 8809 - Fix issue where git repository packages are always re-acquired on target, even if it's the exact same package
  • 8806 - Fixed case-sensitive name filter on Infrastructure Workers page
  • 8804 - Migrate DeprovisionDynamicEnvironmentTask table to use Entity Framework
  • 8805 - Converted OctopusServerNode document persistence from JSON store to relational model

Changes in Octopus Server 2024.3.531

  • 8807 - Improve UX when viewing build information on deployments
  • 8800 - Migrate DeprovisionDynamicEnvironmentForProjectTask table to use Entity Framework
  • 8795 - Account type variable values will use account ID not account name if clicking on 'All Variables' or 'Variable Preview' page and then refreshing that page.
  • 8802 - Support skipping initial health check when creating deployment targets or workers
  • 8793 - Deploying to an environment and a frozen environment at the same time no longer results in a validation error
  • 8797 - Fixed an issue with deployments not always including packages for the same offline drop target when deploying simultaneously

Changes in Octopus Server 2024.3.164

  • 8792 - Improve Git persistence logic to better detect and recover from corrupt repositories
  • 8785 - Added an optional --cancel-wait parameter in Octopus Server's node command to set the time to wait after task cancellation is requested
  • 8775 - Added background migration to remove duplicate Build Information commits and work items from Deployments

Changes in Octopus Server 2024.2.9235

  • 8868 - Fixed UI performance regression on variable edit page
  • 8867 - Large Variables page with lots of scopes is slow to add new value
  • 8727 - Fixed an issue where async zip deploy failed to clean up packages resulting in failed tasks

Changes in Octopus Server 2024.2.9220

  • 8865 - Don't map work items in build information on pages that don't show this information

Changes in Octopus Server 2024.2.9210

  • 8841 - Ensure SQL connections are closed when encountering exceptions during disposal

Changes in Octopus Server 2024.2.9206

  • 8857 - Fixed an issue where certificate metadata validation returns a byte array and throws an exception when using non string inputs like otherName.1 = 1.3.6.1.4.1.111.20.2.3;UTF8:<mailto:0111111111@test.gov|0111111111@test.gov>
  • 8853 - Audit event for non-scheduled deployments should indicate it was immediately deployed

Changes in Octopus Server 2024.2.9202

Changes in Octopus Server 2024.2.9193

  • 8849 - Enable new Project Tenant Variables view by default
  • 8727 - Fixed an issue where async zip deploy failed to clean up packages resulting in failed tasks
  • 8839 - Fixed a duplicate key exception when building telemetry information
  • 8843 - Fixed Add Worker page defaulting to non-existent Kubernetes category
  • 8792 - Improve Git persistence logic to better detect and recover from corrupt repositories
  • 8820 - Missing Jira work items will not block release creation
  • 8799 - Upgraded BouncyCastle.Cryptography dependency from 2.2.1 to 2.3.1
  • 8797 - Fixed an issue with deployments not always including packages for the same offline drop target when deploying simultaneously
  • 8775 - Added background migration to remove duplicate Build Information commits and work items from Deployments

Changes in Octopus Server 2024.2.8921

  • 8787 - Open bulk deployment tasks in the project context instead of the global task view
  • 8789 - Fixed an issue where Kubernetes Object Status didn't run for certain Kubernetes steps when deploying via Kubernetes agents
  • 8790 - Fixed issue with applying PTM licenses
  • 8784 - Convert EventRetentionRun to use Entity Framework
  • 8775 - Added background migration to remove duplicate Build Information commits and work items from Deployments
  • 8352 - Fix bug where machines weren't filtering by deployment target types and shell names

Changes in Octopus Server 2024.2.8486

  • 8786 - Converted GitRepositoryReferenceCacheHighWatermark document persistence from JSON store to relational model
  • 8781 - Migrate Deployment Target Metadata Inspection to use Entity Framework
  • 8782 - Normalised OctopusServerInstallationHistory and converted document persistence from JSON to relational model
  • 8783 - Normalised SampleProject and converted document persistence from JSON to relational model
  • 8780 - Edit tenant related variables and save with single "Save" operation. Did you know that you can use variables filter while keeping unsaved changes and save them all later after all variables were updated
  • 8774 - Synchronize step template parameter default values when updating a step template on projects that use the default value

Changes in Octopus Server 2024.2.8209

  • 8779 - Normalised DeletedSpace and converted document persistence from JSON to relational model
  • 8762 - Normalised ApiKey and converted document persistence from JSON to relational model
  • 8778 - Add a new tab "Build Information" on deployments which lists the build information for all packages part of the deployment
  • 8777 - Custom Octopus extensions are no longer loaded
  • 8719 - Guided failure is now invoked when a step times out
  • 8776 - Cancelling a deployment no longer logs that the execution timeout was reached
  • 8768 - Move task history to a separate tab on the task page and move previous deployments to the overflow menu

Changes in Octopus Server 2024.2.7872

  • 8773 - Convert tab keys to whitespace characters in the Code Editor
  • 8772 - Normalised Blob and converted document persistence from JSON to relational model
  • 8770 - Fixed an issue where the SMTP page was not available in the configuration navigation item list
  • 8757 - Release changes in a single deployment record no longer contain duplicate commit and work items for a package
  • 8067 - Fixed Build Information duplication in a deployment caused by multiple releases containing the same package but not the other duplication scenarios
  • 8501 - Release changes in a single deployment record no longer contain duplicate commit and work items for a package
  • 8766 - Certificate variables from step templates in CaC projects not being picked up within the project step
  • 8628 - Add new Kubernetes Agent deployment target for simplified deployments to Kubernetes

Changes in Octopus Server 2024.2.7573

  • 8759 - Configuration of OIDC Issuer URL is not reflected in /.well-known/openid-configuration
  • 8763 - Fix Kubernetes agents being unable to be updated
  • 8765 - Fixed an issue where external feed triggers could fail with an InvalidOperationException
  • 8764 - Converted Artifact document persistence from JSON to columns
  • 8521 - When auditing variable changes, the variable list maintains a consistent order across the two versions, allowing for a more straightforward comparison of the underlying changes
  • 8756 - Fixes issue where sourcing files from the project repository for a version controlled project would fail if the release was created from a scheduled trigger
  • 8758 - Fixed a bug where a project's deployments page wouldn't show any deployments
  • 8739 - Fix: Parent rolling step no longer fails when child and grandchild have manual intervention steps that are resolved
  • 6634 - Fix: Parent deployments does not wait for child deployments to complete after an interruption
  • 8731 - Fix EnabledFeatures not being added for Azure App Service Step
  • 8755 - Normalised Tenant and converted document persistence from JSON to relational model

Changes in Octopus Server 2024.2.6963

  • 8264 - Octopus no longer attempts to upgrade Tentacles running in a container
  • 7764 - Updated the library used for SSH. This provides improved compatibility with support for newer algorithms (unblocking support for OpenSSH Server 8.8+). SSH targets can now use SHA256 fingerprints for host verification. When adding new SSH targets, Octopus Server will use SHA256 fingerprinting by default
  • 8526 - Fixed issue whereby when using git-sourced scripts, an Octopus variable was considered invalid content for the repository URL; Octopus Variables can now be used for git repository urls
  • 8742 - The variable Octopus.Project.Slug containing the project slug is now available during deployments and runbook runs
  • 6493 - Interruptions in child deployments can now be actioned from the parent deployment task log
  • 8753 - Refactor ServiceNow project extension settings to be backwards compatible
  • 8751 - Normalised WorkerPool and converted document persistence from JSON to relational model

Changes in Octopus Server 2024.2.6366

  • 8750 - Small UI improvement to Server-Side Apply config options
  • 8657 - Fixed issue where file paths field would not be shown in Deploy Kubernetes YAML step properly when sourcing from a Git repository
  • 8580 - Fix an unexpected error that occurs on the triggers page if a branch has been deleted

Changes in Octopus Server 2024.2.6041

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
  • 8746 - Fix database timeout when upgrading Tentacle
  • 8745 - OctopusDeploy linux docker container UID and GID restored to 999 value used by 2023.4 and earlier versions
  • 7707 - Created new api worker task lease endpoint
  • 8743 - Re-introduce custom project template ordering on project tenant variables
  • 8543 - Onboarding page is shown instead of deployment overview when the project does not have a deployment process regardless of the project type
  • 8749 - Added project trigger support for release creation from external container image and Helm chart registries
  • 8741 - Improved re-ordering UX (e.g. when re-ordering environments or lifecycle phases)
  • 8742 - The variable Octopus.Project.Slug containing the project slug is now available during deployments and runbook runs
  • 8676 - Deploy Windows Services now bind empty account passwords correctly
  • 8547 - Expose server side apply configuration for Kubernetes steps
  • 8738 - Added task logs for ITSM precondition checks when creating a change request

Changes in Octopus Server 2024.2.5350

  • 8723 - Audit events are no longer added for the Deployment and Runbook history table
  • 7669 - Fixed sorting order of Steps in the Deployment Step scope dropdown of the variable editor
  • 8690 - Fixed an issue where the browser's back button would need to be clicked twice to go back to the previous page after clicking into a project
  • 8735 - Allow users to choose to automatically transition a ServiceNow Change Request to either Review or Closed after a successful deployment
  • 8722 - Fixed an issue where splitting insights report by project group would result in an error
  • 8710 - Normalised User and converted document persistence from JSON to relational model
  • 8729 - Reduce load on database during health status checks and analytics collection
  • 8730 - Fixed issue with old expired trial license being blocked by tenant limits

Changes in Octopus Server 2024.2.4965

  • 8396 - Ensure task history content is not squished
  • 8728 - Remove possibility of receiving two sets of auth cookies

Changes in Octopus Server 2024.2.4636

  • 8726 - Remove call to API endpoint that requires ConfigureServer permission on the Create Deployment page
  • 8725 - Add space switcher tool-tip to reveal truncated name
  • 8701 - Allow creating an emergency CR in ServiceNow when deploying a release of a project to an environment that both are change controlled
  • 8691 - Fixed an issue where reordering list items in some situations would be duplicated and potentially crashing the ui
  • 8716 - Log ClientDenied messages at Debug level

Changes in Octopus Server 2024.2.4248

  • 8717 - Fixed an issue where a null DisplayName in an external security group would cause authentication to fail
  • 8715 - Watch for Kubernetes Object Status updates as soon as each batch is applied in the case of the Raw Yaml deployments

Changes in Octopus Server 2024.2.4147

  • 8657 - Fixed issue where file paths field would not be shown in Deploy Kubernetes YAML step properly when sourcing from a Git repository
  • 8711 - Added telemetry on Tentacle certificate signature algorithms
  • 8678 - Improve initial load of data on project tenants page and prevent old data from being displayed during a connection

Changes in Octopus Server 2024.2.3973

  • 8702 - Improved API performance when requesting many spaces, channels, or action templates
  • 8585 - Updating usages of step templates that use a git dependency will now include any updates made to the git configuration. To synchronise any existing usages make a small change to the step template and then update it's usages
  • 8675 - Fix bug where full screen variable editor doesn’t take up all available space
  • 8697 - Resizing browser window can reload and unsaved changes lost
  • 8699 - Reduce query overhead on runbook runs page when there are no runs for the runbook
  • 8708 - Fixed a regression causing HTTP requests to intermittently respond with HTTP 500 errors
  • 8696 - Fix issue where extra machines would appear in the Machine group on deployment steps
  • 8693 - Normalized UserRole and converted document persistence from JSON store to relational model

Changes in Octopus Server 2024.2.2914

  • 8686 - Overhauled Step Selection screen to reduce confusion and make it easier for K8s users to choose the appropriate step
  • 8685 - Converted ScopedUserRole document persistence from JSON store to relational model
  • 8564 - Fix pull request URLs for GitLab repositories in a subgroup
  • 8692 - Calamari distribution no longer differentiates between Calamari.exe and Calamari.Cloud.exe
  • 8688 - Converted UserSession document persistence from JSON store to relational model

Changes in Octopus Server 2024.2.2502

  • 8670 - Polling worker Tentacles are slower when running many concurrent deployments (or concurrent steps).
  • 8687 - The deployment freeze override dialogue will no longer appear when there are errors creating deployments
  • 8683 - Converted Team document persistence from JSON store to relational model
  • 8679 - Routing to invalid space shows dashboard of default space
  • 8682 - Removed 5 redirect links from Global Search
  • 8680 - Fixed an issue where JIRA integration was using an incorrect link for the release deployment details page resulting in the page not being found
  • 8672 - The Octopus Server docker container now uses the TASK_CAP environment variable to set the task cap for node

Changes in Octopus Server 2024.2.2075

  • 8673 - Add/edit source code in Terraform steps has a small textarea

Changes in Octopus Server 2024.2.1902

  • 8668 - Disabled /reporting/deployments-counted-by-week API endpoint
  • 8658 - Fix Excel prompting for user credentials when updating our Excel reporting template to use your own Octopus instance
  • 8573 - Fixed an issue where file access to the same git resource in parallel would cause a deployment failure

Changes in Octopus Server 2024.2.1511

  • 8667 - Disabled project level /git/branches API endpoint
  • 8669 - Disabled Project level /runbooks/all API endpoint
  • 8666 - Fixed an issue where clicking on a worker machine that requires a tentacle upgrade will navigate to the wrong page and display a not found error

Changes in Octopus Server 2024.2.1310

  • 8664 - Fixed regression that prevented guest users from viewing config as code projects
  • 8659 - Converted RunbookRunHistory document persistence from JSON store to relational model

Changes in Octopus Server 2024.2.855

Breaking Changes
  • 8615 - Breaking change: Internal changes made to Kustomize step resulting in slight UI differences and OCL changes. The only breaking change is the payload to create the Kustomize step via the API is slightly different so any existing external api calls that attempt to create the Kustomize step with the old payload will fail
Other Changes
  • 7461 - Migrated from ADAL to MSAL for Azure service principal accounts. This change applies to fetching authentication tokens, which are consumed by the management clients for storage accounts, resource groups, and web apps

Changes in Octopus Server 2024.2.534

  • 8651 - Fixed an issue where setting the OIDC Issuer URL was not updating the values in the .well-known/openid-configuration response
  • 8653 - Project Tenant Variables becomes the default experience, with an opt-out, to manage tenant variables from the context of a project
  • 8652 - Display 'Missing resource' text instead of permission error for project variables
  • 8654 - Always keep "edit" button visible in Tenant Variables page
  • 8636 - Show Octopus version for nodes listed on node page
  • 8467 - Fixed an issue preventing the slugs of existing lifecycles from being updated
  • 8650 - AWS accounts with OIDC used on Terraform steps fails to login with error.

Changes in Octopus Server 2024.2.101

  • 8646 - Improve loading of required accounts, certificates and worker pools on project tenant variables
  • 7481 - Fixed runbook or deployment process scoped worker-pool variable resolution
  • 8258 - Fixed runbook or deployment process scoped account variable resolution
  • 8571 - Fixed an issue that prevented users from setting a default channel on a project
  • 8576 - Fixed an issue where SupplementalGroups and RunAsUserId were not populated in the Edit Yaml section for the "Deploy a Kubernetes container" step

Changes in Octopus Server 2024.1.12890

  • 8881 - Log HTTP 500 errors correctly in the web request logging file