Confluence Upgrade Matrix

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community



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

6.13
(LTS)

6.13 is a Long Term Support release. Learn more 
  • Delete user accounts
  • PDF export improvements
  • Support for AdoptOpenJDK 8
  • Migration Assistant for Confluence
  • Add page numbers to PDF exports the easy way (6.13.3 and later)
  • Ability to choose between Edit in Office and Companion App (6.13.6 and later)

Release Notes
6.14
  • Improved search UI
  • Editor upgrade
  • Delete a user's profile picture
  • Add page numbers to PDF exports the easy way
Release Notes
6.15
  • Filter search by space category
  • Changes to the backup and restore screen
Release Notes
7.0
  • Automated Synchrony data eviction
  • CDN support to ease geo-performance issues
  • Pre-upgrade planning tools
Release Notes
7.1
  • Java 11 support
  • Exclude attached files when copying a single page
  • Improvements to the Content by Label, Change History, and Spaces List macros
  • Extended support for Edit in Office
Release Notes
7.2
  • Access Data Center features without setting up a cluster
  • MySQL 8 support
Release Notes
7.3
  • More control when editing files
  • Companion app support for session-based virtual desktops
  • Check who can view a page and share with confidence
  • Advanced permissions management for easier administration
  • Self-protect and sleep easy with rate limiting
Release Notes
7.4

7.4 is a Long Term Support release. Learn more

Release Notes
7.5
  • Advanced auditing
  • Single sign-on with OpenID
  • More table cell colours
  • Widget connector improvements
Release Notes
7.6
  • Additional audit log events
  • Trusted domains for Companion app
Release Notes
7.7
  • Webhooks
  • Reindex in a cluster
  • Editor upgrade
  • Accessibility improvements
  • New audit log filters and file retention settings
  • Just-in-time user provisioning

Release Notes
7.8
  • Search performed audit log event
  • Disabled macros keep their body content
  • Increased label limit for Page Properties Report macro
Release Notes
7.9
  • Install bugfixes without downtime
  • Personal access tokens 
  • Office documents load in their own time

Release Notes

Critical bug fixes

6.13
(LTS)

6.13 is a designated Long Term Support release, meaning it offers backported critical security, stability, data integrity, and performance fixes while this version is supported . Learn more  

Summary
Loading...
Refresh

All 6.13.x bug fixes
6.14

Summary
Loading...
Refresh

All 6.14.x bug fixes
6.15

Summary
Loading...
Refresh

All 6.15.x bug fixes
7.0

Summary
Loading...
Refresh

All 7.0.x bug fixes
7.1

Summary
Loading...
Refresh

All 7.1.x bug fixes
7.2

Summary
Loading...
Refresh

All 7.2.x bug fixes
7.3

Summary
Loading...
Refresh

All 7.3.x bug fixes
7.4

Summary
Loading...
Refresh

All 7.4.x bug fixes
7.5

Summary
Loading...
Refresh

All 7.5.x bug fixes
7.6

Summary
Loading...
Refresh

All 7.6.x bug fixes
7.7

Summary
Loading...
Refresh

All 7.7.x bug fixes
7.8

Summary
Loading...
Refresh

All 7.8.x bug fixes
7.9

Summary
Loading...
Refresh

All 7.9.x bug fixes

Supported platforms changes

6.13
(LTS)

Ended support for:

  • PostgreSQL 9.3

Added support for:

  • AdoptOpenJDK 8
Supported Platforms
6.14No changesSupported Platforms
6.15No changesSupported Platforms
7.0

No changes

Supported Platforms
7.1

Added support for:

  • Java 11
Supported Platforms
7.2

Added support for:

  • MySQL 8
Supported Platforms
7.3

Added support for:

  • PostgreSQL 10
  • Oracle 19c
Supported Platforms
7.4

Ended support for:

  • PostgreSQL 9.4
  • MySQL 5.6 
  • Oracle 12c R1
  • Microsoft SQL Server 2012
Supported Platforms
7.5

Ended support for:

  • Internet Explorer 11
  • PostgreSQL 9.5
  • Microsoft SQL Server 2014
Supported Platforms
7.6No changesSupported Platforms
7.7No changesSupported Platforms
7.8No changesSupported Platforms
7.9No 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. 

6.13
(LTS)

6.13 is a Long Term Support release. Learn more 
  • Styling of PDF exports have been improved. There have been some behaviour changes, so check the full upgrade notes
  • There is a known issue when running Confluence on Linux with AdoptOpenJDK. You may need to install a font configuration package.
  • New Infrastructure recommendations for enterprise Confluence instances on AWS can help you plan a suitable environment, or check whether your current instance is adequate for the size of your content and traffic.
  • 6.13.6 added system property to re-enable Edit in Office, which was replaced by Companion app in Confluence 6.11.
  • 6.13.18 upgraded the bundled PostgreSQL JDBC driver to 42.2.16.

Upgrade Notes
6.14
  • New users are no longer be required to upload a profile picture or watch a space when they log in for the first time.
  • A new scheduled job will check for problems in your CONFANCESTORS table each day.
Upgrade Notes
6.15
  • The Share a link blueprint now requires URLs to be whitelisted.
  • Wiki markup will no longer be rendered in search results
Upgrade Notes
7.0
  • Synchrony tables will be truncated during the upgrade. This upgrade task may take some time to run.
  • Unsupported CDN dark feature has been removed.
  • Ended support for a number of macros and gadgets, and removed them from the macro browser.
  • Configuring a mail server in the Confluence distribution has changed.
Upgrade Notes
7.1
  • Some Java 8 arguments aren't recognized in Java 11. If you plan to switch to Java 11, to avoid startup problems, apply your customisations manually, don't simply copy over your file or Java options.  
  • The spaces list macro now only shows current spaces by default.
Upgrade Notes
7.2
  • We now limit the size of the chart macro.
  • If you plan to upgrade to MySQL 8, you'll need to switch your database driver.
Upgrade Notes
7.3
  • We now limit the number of pages that initially display in the page tree.
  • Companion app 0.6.2 and earlier won't work with Confluence 7.3. Upgrade to 1.0.0.
  • Java 11 now bundled for use with the installer.
Upgrade Notes
7.4

  • We've resolved several issues with Inspect permissions feature that impact sites with complex external directory setups
  • 7.4.4 we now prevent users from applying the drop shadow image effect to images larger than 2000x2000 pixels. You can change this limit with a system property. 
  • 7.4.6 upgraded the bundled PostgreSQL JDBC driver to 42.2.16.

Upgrade Notes
7.5
  • Existing audit log events will be migrated on upgrade. More detail
  • Page Properties Report macro now limited to 500 pages.
  • Import from Word now has a configurable maximum file size.
  • Collaborative editing limited mode has been removed.
  • JavaMail is now JakartaMail. This changes how you configure your mail server in the Confluence distribution.
Upgrade Notes
7.6
  • Change to the URL the mobile app login compatibility check uses. You may need to update your firewall or load balancer.
Upgrade Notes
7.7
  • New Data Center apps check as part of your license upgrade

  • New system properties for audit log, page properties report, and drop shadow image effect.
Upgrade Notes
7.8
  • You can't upgrade to 7.8.0 directly if you use the H2 database

  • Word and Excel conversion now handled by the external process pool

  • Allowlist and blocklist replace whitelist and blacklist in the Confluence UI

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 7

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 7.xUpgrade directly to the latest version of Confluence 7.

If you are upgrading to the next bug fix update (for example, from 7.9.0 to 7.9.4), you can upgrade with no downtime.

(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 Sep 28, 2020

Was this helpful?

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