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 3.16.7 to 3.17.8
Octopus 3.17
Changes in 3.17
See our release blog post for more details.
New Features
Octopus 3.17 introduces first-class Java support so teams can start deploying their Java apps in a safe, repeatable and reliable way!  This release includes support to deploy to Tomcat, RedHat JBOSS EAP and Wildfly application servers and the Octopus built-in repository can now manage Java packages like jar, war, ear and rar files.
Improvements
- Swagger support for the Octopus API
 - Improved user administration and authentication performance
 
Breaking Changes
There are no breaking changes in this release.
Upgrading
All of the usual steps for upgrading Octopus Deploy apply.
Release notes
These are the features and fixes you'll get by upgrading from 3.16.7 to 3.17.8.
Changes in Octopus Server 3.17.8
- 3213 - Variables now allow escaped strings in conditionals in JSON
 - 3757 - Fixed an issue where the current Octopus Server node could not be found during the heartbeat
 - 3863 - OpenID Connect security groups no longer get cleared by the sync task when AD isn't also enabled
 - 3865 - User permissions cache is updated on OpenID Connect login, so groups changes take effect immediately
 - 3866 - Failing a heartbeat now persists demotion to follower
 - 3872 - Fixed a Mutex exception when deploying IIS steps on PowerShell 2.0
 - 3873 - Fixed an exception loading script modules containing certain characters
 
Changes in Octopus Server 3.17.7
- 3864 - Prevent a potential security vulnerability (
CVE-2017-15611) by further restricting User Invite action to those with TeamEdit and TeamCreate permissions - 3868 - When an offline drop target has defined the 
Encryption passwordall variables will now be encrypted into the sensitive variables (CVE-2017-15610) - 3869 - The special Guest account is now denied access to certificate private keys, even if that user has been granted the 
CertificateExportPrivateKeypermission (CVE-2017-15610) 
Changes in Octopus Server 3.17.6
- 2575 - The API now returns a 400 instead of 500 response when an empty body is posted or putted
 - 2639 - Fixed UAC permission elevation in management tool
 - 2662 - Error message when importing a script module that contains a syntax error now points to the actual script module that caused the error
 - 3579 - Fixed issue where adding last node in HA cluster broke the management tool
 - 3808 - Fix Octopus upgrade failure caused by empty value in table Event RelatedDocumentIds column
 - 3812 - Resolved migrator issue where project was prevented from being migrated by deployment step with hidden empty package ID
 - 3814 - Clarified the duplicate variable message to emphasise a user variable is overwriting a step field
 - 3819 - Duplicate variable warning no longer returns a false positive when a variable is scoped to a role
 - 3850 - Fixed an issue that caused unavailable machines to be re-included in a deployment
 - 3851 - Prevented IIS semaphore releasing too many times during high contention deployments
 - 3852 - Added support for down-level login names (
domain\user) when performing Tentacle upgrades with a specific account - 3853 - OpenID Connect authentication providers correctly update groups from roles on user login
 
Changes in Octopus Server 3.17.5
Changes in Octopus Server 3.17.4
- 2572 - The node ping page 
api/octopusservernodes/pingnow returns name, status and version information for the node - 2915 - Added a 
Octopus-NodeHTTP header that shows which server served the request - 3497 - Added variables for 
Octopus.Task.QueueTimeandOctopus.Task.QueueTimeExpiry - 3780 - Scheduled deployments now deploy to the machines available when the deployment is executed (instead of when the deployment is created)
 - 3781 - Fixed a memory issue with LogContext and sensitive variables
 - 3809 - Add retry logic to the send email step to reduce chance of failing a deployment due to sporadic connectivity issues with SMTP server
 - 3815 - Bundled tentacle 
3.16.0that includes--proxyoption onTentacle.exe register-withso a proxy server can be set when registering a tentacle on the command line - 3816 - Fixed an error when updating steps after changing a step template variable name
 - 3817 - Package acquisition better accommodates parallel steps
 - 3818 - Guided failure details now display which action and machine failed
 - 3824 - Added the variable 
Octopus.Action.Output.Manual.Approvedto indicate if a manual intervention action was approved - 3826 - API returns the correct status codes again for loadbalancer ping (
418when draining) and resource creation (201) - 3838 - Fixed an issue collecting machine variables during multi tenant deployments
 
Changes in Octopus Server 3.17.2
Changes in Octopus Server 3.17.1
- 3591 - Fix for permission combination that allowed viewing of variables that user did not have access to
 - 3762 - Fixed 
Unable to parse sensitive-variables as valid JSON.error inTransfer packagestep on SSH targets due to decryption password was not being passed correctly - 3784 - Sensitive tenant variables that use variable expression can now be changed and set to a custom value
 - 3785 - The system task 'Fail orphaned tasks' has been renamed 'Clean orphaned tasks'
 
Changes in Octopus Server 3.17.0
- 3506 - Service account users can be linked to an Active Directory account and will use that account's groups for team membership in Octopus
 - 3667 - External security group synchronization, with authentication providers like Active Directory, has been moved into a scheduled task to fix performance and stability problems
 - 3740 - On startup Octopus will delete obsolete files leftover from old Octopus Server installations
 - 3744 - Maintain certificate friendly-name
 - 3758 - Fixed a bug where the scheduled deployment icon and tooltip in the dashboard would not display
 - 3760 - Added variable 
OctopusSuppressDuplicateVariableWarningto allow logging duplicate variables warning as verbose - 3761 - 
show-configurationcommand now includes watchdog status - 3764 - Set initial project filter on tenant-project-variables page to alleviate performance issues with large variable count
 - 3766 - Remove 'beta' label from 'Mono not installed' option for SSH targets
 - 3767 - Support for java packages in the built-in package feed
 - 3768 - Deploy Java Archive deployment step
 - 3769 - Tomcat deployment steps
 - 3770 - WildFly/JBoss EAP deployment steps
 - 3771 - Resolved issue with incorrect certificate thumbprint being copied to clipboard
 - 3776 - Fixed a bug where the duplicate variable warning is logged when auto-deploying a release to a machine when redeploy on the trigger is enabled
 - 3777 - Swagger Documentation of live system
 - 3779 - Reduced the frequency of the 'Fail orphaned tasks' task