Confluence Upgrade Matrix



Need help deciding which version of Confluence is best for your team? Use this matrix to compare version features, critical bug fixes, supported platforms, and technical upgrade procedures. We've also outlined specific upgrade paths to make your upgrade as seamless as possible.

Ready to upgrade? Head to Upgrading Confluence for a step-by-step guide. 

About Long Term Support releases

A Long Term Support release is a feature release that gets backported critical security updates and critical bug fixes during its entire two-year support window. If you can only upgrade once a year, consider upgrading to a Long Term Support release. Learn more

Long Term Support releases were originally referred to as Enterprise Releases.

On this page:

Top features

8.0
  • Introducing the emoji menu
  • Improvements to search ranking logic
  • Easier workflows for license usage management
  • Accessibility improvements and fixes
  • Several platform and library upgrades
  • Support for Java 17
Release Notes
7.20
  • Edit and browse with greater accessibility using skip links
  • Add your Advanced Roadmaps in Jira to Confluence
  • Create feedback reports to troubleshoot content problems
  • Troubleshoot effectively with more diagnostic tools
Release Notes
7.19 (LTS)

7.19 is a Long Term Support release. Learn more

Release Notes
7.18
  • Select cluster node on logging and profiling screen

  • New /scan REST API endpoint

Release Notes
7.17
  • Make your integrations more secure with OAuth 2.0
  • Keep your site running like clockwork with new application metrics
  • Encrypt your database password for greater security
  • Updated VPAT documents for accessibility improvements
Release Notes
7.16
  • Use retention rules to clean up historical data automatically
  • Use multiple identity providers (IdPs) for single sign-on
  • Block basic authentication
  • Faster permissions checks for complex sites
  • Exclude spaces from the data pipeline
Release Notes
7.15
  • No new features in this release
Release Notes
7.14
  • Upgrade to the next Confluence version without downtime
  • Schedule regular data pipeline exports
  • Change the data pipeline export location
  • Deleted date now displays in trash
Release Notes
7.13
(LTS) 

7.13 is a Long Term Support release. Learn more

Release Notes
7.12
  • Use data pipeline to export data into your existing data platform
  • Diagnostic information is now included in thread dumps
  • Change to database validation query configuration
  • setenv file improvements
  • Support for PostgreSQL 11
Release Notes
7.11
  • Analytics for Confluence is now part of Confluence Data Center
  • Team Calendars is now part of Confluence Data Center
  • Mark logs when troubleshooting issues

  • Access logging enabled by default
  • Dedicated application log files security, outgoing mail, and indexing

Release Notes
7.10
  • Jira Service Desk is now Jira Service Management
Release Notes

Critical bug fixes

8.0

Summary
Loading...
Refresh

All 8.0.x bug fixes
7.20

Summary
Loading...
Refresh

All 7.20.x bug fixes
7.19 (LTS)

Summary
Loading...
Refresh

All 7.19.x bug fixes
7.18

Summary
Loading...
Refresh

All 7.18.x bug fixes
7.17

Summary
Loading...
Refresh

All 7.17.x bug fixes
7.16

Summary
Loading...
Refresh

All 7.16.x bug fixes
7.15

Summary
Loading...
Refresh

All 7.15.x bug fixes
7.14

Summary
Loading...
Refresh

All 7.14.x bug fixes
7.13
(LTS)

Summary
Loading...
Refresh

All 7.13.x bug fixes
7.12

Summary
Loading...
Refresh

All 7.12.x bug fixes
7.11

Summary
Loading...
Refresh

All 7.11.x bug fixes
7.10

Summary
Loading...
Refresh

All 7.10.x bug fixes

Supported platforms changes

8.0

Added support for:

  • Java 17

Ended support for:

  • MySQL 5.7
  • PostgreSQL 11
  • H2 embedded database
  • JNDI datasource connections
  • Java 8
  • UTF8 encoding for MySQL
Supported Platforms
7.20

Ended support for:

  • Oracle 12c
Supported Platforms
7.19 (LTS)No changesSupported Platforms
7.18

Ended support for:

  • PostgreSQL 10
Supported Platforms
7.17

Added support for:

  • PostgreSQL 12
  • PostgreSQL 13
  • PostgreSQL 14

Ended support for:

  • Microsoft SQL Server 2016
Supported Platforms
7.16

Added support for:

  • Microsoft SQL Server 2019
Supported Platforms
7.15No changesSupported Platforms
7.14

Ended support for:

  • PostgreSQL 9.6
Supported Platforms
7.13
(LTS)

Ended support for:

  • Microsoft Edge Legacy
Supported Platforms
7.12

Added support for:

  • PostgreSQL 11
Supported Platforms
7.11No changesSupported Platforms
7.10No changesSupported Platforms

When upgrading from an older Confluence version, where there is no crossover between supported platforms, you may need to upgrade via an intermediary version that supports both your current platform version and future one. For example, if you're running Confluence 5.4 with Oracle 11g and want to upgrade to Confluence 6.x which only supports Oracle 12c, you will need to upgrade via Confluence 5.7 where both Oracle 11g and 12c are supported:

  1. Upgrade to Confluence to 5.7
  2. Upgrade Oracle to 12c and check things run smoothly
  3. Upgrade to Confluence to 6.x 

Technical upgrade notes

This table is a high level summary of the upgrade notes, you should read the full upgrade notes before upgrading. 

8.0
  • Recommended upgrade paths to Confluence 8
  • Upgrading to 8.0 requires downtime
  • H2 database support removed
  • UTF8MB4 encoding for MySQL databases
  • Changes to table and macro display in the editor
Upgrade Notes
7.20
  • Greater security with IMDS v2 implementation

  • Changes to the order of items in the admin navigation
Upgrade Notes
7.19 (LTS)

7.19 is a Long Term Support release.

Upgrade Notes
7.18
  • No upgrade notes for this release
Upgrade Notes
7.17
  • Change to JMX monitoring
  • Invalid license check
Upgrade Notes
7.16
  • Changes to page and attachment version numbering

Upgrade Notes
7.15
  • No upgrade notes for this release
Upgrade Notes
7.14
  • Default connection pool provider has changed from  c3p0 to Hikari.
  • Any pages already in the trash at the point you upgrade will get the upgrade date as their deleted date.
Upgrade Notes
7.13
(LTS)

  • 7.13 is a Long Term Support release

Upgrade Notes
7.12
  • Known issues with Java 11 and TLS 1.3 which has been added to the default server and client protocols in the setenv.sh and setenv.bat files
  • Changes to the layout of the setenv file
Upgrade Notes
7.11
  • Upgrade will fail on Oracle 12 release 1 (not supported)
  • Upgrade will fail on some Microsoft SQL Server 2016 versions
  • Upgrade will fail on MySQL 8 if database user does not have adequate permissions
  • Changes required to your backup procedure for MySQL
  • Page index macro limited to 1000 pages
  • Access logs enabled by default, you may need to provision more disk space
  • Some entries in the atlassian-application.log file are now sent to a dedicated log file
  • Outbound requests from application link URLs require users to be authenticated, unless you specifically allow anonymous users in the allowlist.
  • Analytics is now enabled for Data Center, review the data retention settings to make sure they are appropriate for your organization
  • GoodSoftware Analytics for Confluence users will need to re-apply global analytics permissions after upgrading to 7.11 Data Center
Upgrade Notes
7.10
  • PostgreSQL driver upgrade
  • Login with query parameter no longer supported
  • Synchrony Xmx memory increased to 2 GB
  • XStream upgrade may impact your custom developed apps
Upgrade Notes
7.9
  • Search index split into a content index and change index

Upgrade Notes

Collaborative editing with proxies and/or SSL

Collaborative editing is powered by Synchrony which synchronizes data in real time. Synchrony is executed as a separate process by Confluence Server and managed by Confluence automatically. Under normal circumstances, it should not need to be managed manually by an administrator.

You may, however need to make changes to your proxy configuration. We made significant improvements in Confluence 6.1, so recommend upgrading to that version or later if you plan to use collaborative editing. 

Upgrading to Confluence 6.0...

If you're ready to implement Collaborative editing, we recommend jumping to 6.1.0 or above. We've made significant changes in 6.1 to make it easier to configure Synchrony with proxies and/or SSL.

If you do plan to upgrade to 6.0.x:

Upgrading to Confluence 6.1 or later...

Have a look at Proxy and SSL considerations to find out whether you need to make any changes to your reverse proxy or SSL configuration. There are a number of configurations to choose from, but only some will require a change to your proxy configuration.

If you experience problems, see Troubleshooting Collaborative Editing.


Upgrade Now



Upgrade path

Upgrading from 6.0 or later

You can upgrade to any 7.x version at any time! Check the upgrade notes above to make sure everything is compatible, and you're prepared for the transition.

Use the table below to determine the most efficient upgrade path from your current version to the latest versions of Confluence.

Your Version

Recommended upgrade path to Confluence 8

2.7 or earlierUpgrade to 2.7.4 then upgrade to 3.5.17, and follow paths below.
2.8 to 3.4Upgrade to 3.5.17, and follow paths below.
3.5

Upgrade to 5.0.3, and follow paths below.

4.0 to 4.3 

Upgrade to 5.10.x, and follow paths below.

5.0 to 5.10Upgrade to 7.19.x, and follow paths below.
6.0.5 to 8.xUpgrade directly to the latest version of Confluence 8.

(warning)  Before you begin, it's critical that you follow all of the steps in Upgrading Confluence. Confluence 7.x is a major upgrade, so it is important that you take a full backup, and test your upgrade in a non-production environment before upgrading your production site.



tip/resting Created with Sketch.

Post upgrade checklist

Once you have completed the steps required to upgrade your Confluence installation, check all the items on the Confluence post-upgrade checklist to ensure that everything works as expected. If something is not working correctly, check for known Confluence issues in the Upgrade Notes and try troubleshooting your upgrade as described.

Last modified on Oct 30, 2018

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.