Released: Tuesday, May 18, 2021

What's new in 2021.1

These are the most important features you'll get by upgrading.

Octopus 2021.1


Octopus 2021.1 is part of the Octopus 2021 Q2 release and delivers a better cloud experience. With this release, you can:

  • Migrate Octopus projects to Octopus Cloud with self-service export/import.
  • Integrate Octopus more easily with GitHub Actions and HashiCorp's Terraform.
  • Deploy your Azure web apps with our improved Azure App Service step.
  • Scale Octopus Cloud as your needs grow:
    • Run more concurrent automation tasks.
    • Persist more build and automation artifacts with best-in-class storage.
  • Configure the Tentacle agent without root or admin permissions.

Read our blog post to learn more.

Breaking changes

This release includes one breaking change.

Change to support for Windows Docker images

We have deprecated Windows Docker images for Octopus Server and Octopus CLI as customer uptake was low and Microsoft no longer supports the OS versions we were publishing (Windows 1809, 1903, and 1909).

Customers are encouraged to use the Linux Docker image instead. Existing Windows images for Octopus Server and Octopus CLI will remain available from our Docker Hub repository, but those tagged as latest will no longer work on Windows.

Octopus CLI is available as an exe, a .NET Core global tool, or via chocolatey. Please refer to our downloads page.

We will continue to publish Windows Docker images for Tentacle. Once we've updated the images for Tentacle to Windows 2019 and Windows 20H2, we will deprecate the existing Windows 1809/1903/1909 containers.

Release notes

Changes in Octopus Server 2021.1.8018

  • 7371 - Fixed an issue where Structured Configuration Variables were not correctly applying to XML files
  • 6794 - Fixed an issue where Structured Configuration Variables were failing to correctly process XML files without the *.xml file extension (eg *.config)
  • 7177 - Fixed an issue where Structured Configuration Variables were failing to correctly process .properties files, and instead treating them as .yaml files

Changes in Octopus Server 2021.1.7906

  • 6915 - Events with long messages can now be exported with migrator

Changes in Octopus Server 2021.1.7856

  • 7115 - Mutli-line service message are now parsed correctly

Changes in Octopus Server 2021.1.7853

  • 6965 - Improved detection of a NuGet V3 feed and handling of NuGet V3 feeds that don't fully implement the NuGet V3 specification

Changes in Octopus Server 2021.1.7849

  • 6743 - Project variables can be overridden and deployed without warning that variables have been changed

Changes in Octopus Server 2021.1.7826

  • 6988 - Ensure certificate subject and issuer are stored in the RFC2253 standard

Changes in Octopus Server 2021.1.7818

  • 7060 - Fixed a "resource not found" issue when viewing old deployments

Changes in Octopus Server 2021.1.7787

  • 7046 - More audit event links point to /not-found

Changes in Octopus Server 2021.1.7782

  • 7040 - Removed some links in the audit log that pointed to /not-found
  • 7014 - Main menu UI bug with safari MacOS
  • 6183 - Add full screen expander and variable insert button to YAML editor on Helm step
  • 7012 - Remove UI option to select execution container for Manual Intervention, Health Check and Deploy Release steps

Changes in Octopus Server 2021.1.7738

  • 6958 - Fixes custom proxy support for Azure WebApp Target Health Check
  • 6990 - Azure AppService step now downloads publishing profile for the deployment target site and uses publishUrl property to perform the deployment
  • 6989 - Default to Azure Global Cloud when Configure Isolated Azure Environment connection is selected, but no specific environment has been selected
  • 6975 - Fixes ordering of Kubernetes environment variables to allow substitution of Downstream APIs
  • 6985 - Fixed EventRelatedDocument SQL parameter limit bug
  • 6983 - Improved speed and reduced disk usage of upgrade script (Script0266)

Changes in Octopus Server 2021.1.7665

  • 6964 - Extra slash after hostname during api request returns 405 error (unless using partialName)
  • 6969 - Scheduled triggers can create new releases when a deployment process has script steps that reference packages
  • 6919 - Runbooks default to environment-level guided failure settings
  • 6967 - Logic to apply a mask changed from previous versions of Octopus.

Changes in Octopus Server 2021.1.7638

  • 6941 - The default user proxy is utilised in the¬†x64¬†binary for windows and the PowerShell bootstrapper will accept proxy server configuration values that do not parse as fully qualified URIs (e.g. hostnames or IP addresses)

Changes in Octopus Server 2021.1.7608

  • 6949 - Fixed an issue where retrieving external feed packages with multi-part prerelease labels in the version would result in "The package was not found in the feed"
  • 6947 - Fixed an issue where a non-existent package action could be selected for Release Versioning

Changes in Octopus Server 2021.1.7595

Breaking Changes
  • 6917 - Fixed an issue where the Tentacle retention policy of an earlier phase of a lifecycle was being used for a later phase if the later phase policy was left as default
Other Changes
  • 6948 - Fixed an issue where multiple transactions being concurrently open lead to requests failing and timing out
  • 6947 - Fixed an issue where a non-existent package action could be selected for Release Versioning
  • 6939 - AWS SDK bundled with Calamari is unable to recognise/deploy to AF-South-1
  • 6953 - Performance improvements to the project channels endpoint
  • 6818 - Fixed an issue where scoped variables used as step template certificate/account parameters were not being evaluated correctly
  • 6930 - More than 10 worker pools are available from variable selection when more than 10 exist

Changes in Octopus Server 2021.1.7500

  • 6933 - Can't import a Bento package if the project doesn't reference a Library Variable Set but its Release still does
  • 6881 - Kubernetes steps that support creation of Ingress resources will now output with apiVersion v1
  • 6937 - SSH Targets using a proxy will now pass health checks
  • 6936 - Improved performance for the Tenants > Variables page

Changes in Octopus Server 2021.1.7469

  • 6934 - Connection will try to determine which algorithm was used to get the original fingerprint and priorities algorithms accordingly
  • 6931 - Fixed performance issues with fetching projects and dashboard environment progression
  • 6926 - Version masks only applied if the version ends with a period and then an 'i' or 'c'
  • 6739 - Make Step Template Parameter Control Type a required field
  • 6920 - Stop alphabetical sort of environment, worker pool and custom dropdowns
  • 6907 - In Infrastructure -> Deployment Targets, filtering by Tenant name with more than one Tenant yields no results
  • 6908 - Tenant Tags correctly filter deployment targets on Infrastructure screen
  • 5408 - Fixed auto-promote failing on some tenants when deploying a lifecycle to multiple tenants
  • 6905 - Running Structured Configuration Variables over YAML files that contain comments will now preserve the structure of the file correctly

Changes in Octopus Server 2021.1.7316

  • 6813 - Runbooks with process-scoped prompted variables fail to run due to missing variable values from other scopes
  • 6898 - Fixing a transaction connection from our document stores
  • 6902 - Azure App Service step times out after 100 seconds when uploading package
  • 6900 - Steps run on Octopus Server using execution containers will now authenticate to Docker registries correctly
  • 6886 - Modifying a 'Copy of' template fails on save
  • 6833 - Invalid day names can be used in cron expressions resulting in the "Triggers" overview becoming inaccessible
  • 6889 - "How to Push Packages" Tooltip is not Space aware

Changes in Octopus Server 2021.1.7236

  • 6896 - Add to HA Cluster works again via the Wizard
  • 6892 - Re-added ability to remove user space managers
  • 6895 - Usage tab on step templates works again
  • 6891 - Azure App Service step errors if no connection strings supplied and app settings are supplied

Changes in Octopus Server 2021.1.7198

  • 6899 - Returned to the previous default for the TrustServerCertificate connection string option
  • 6883 - Days of the month and week are now ordered correctly again
  • 6887 - Bundled the tentacle that ignores errors running the hardening script on install
  • 6880 - Certificates with blank Subject or Issuer names no longer return an error
  • 6659 - Migrator import doesn't import runbook snapshots
  • 6799 - Included the community action templates when exporting a runbook

Changes in Octopus Server 2021.1.7149

  • 6872 - Improved English representation of Cron expressions in portal
  • 6861 - Variables scoped to a step have "undefined" appended to the name of the step after upgrading
  • 6871 - Azure App Service step
  • 6860 - Fixes a bug in which IIS Features did not work on the Deploy a Package step in certain Windows environments
  • 6857 - The correct build of Calamari is sent to 32bit targets again
  • 6835 - Added support for Terraform CLI v0.15.0
  • 6802 - The Octopus Server version number is now displayed as major.minor (Build buildcounter)
  • 6795 - Fixes an issue where changes to the deployment process could not be saved when the versioning strategy is set to "Use the version number from an included package"
  • 6754 - Added Architecture to the response whenever machine is referenced in an API call
  • 6752 - Possible fix for Email notification step hanging intermittently
  • 6745 - Removed extra space from deployment audit messages
  • 6719 - Notes are now snapshotted with the deployment process
  • 6728 - Upgrade Helm Chart step won't log warning if default values.yaml file not present
  • 6730 - The delete-instance command now cleans up the legacy registry instance store as well as the file system instance store
  • 6693 - Deploy Release step will skip rather than fail when a tenant is not connected to project/environment
  • 6721 - Local Administrator permissions are no longer required for most Octopus.Server commands
  • 6738 - Azure Managed Service Identity is now supported for authentication to Azure SQL

Unsure which version is a compatible upgrade? Compare releases.

Looking for older versions of Octopus? Download older versions.