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.

About Enterprise releases

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

On this page:

Top features

6.0
  • Collaborative editing!
    Multiple users can concurrently edit a page together. Changes are automatically saved so that unpublished work is always available.
  • Copy a page and all its child pages (925 votes), and choose where to copy to.
  • Delete a page and all its child pages in one go.

If you're keen to implement collaborative editing, we recommend jumping to 6.1.x or later which contain lots of improvements.

Release Notes
6.1
  • Atlassian Team Playbook blueprints: create health monitors, DACIs, project posters, and more
  • Its now easier to set up and get started with collaborative editing
  • New Chinese language pack
Release Notes
6.2
  • Invite people to edit an unpublished page with you - right from inside the editor
  • Improvements to how you request access to a restricted page
  • New Finnish, Italian, Norwegian, and Romanian language packs
Release Notes
6.3
  • Stability and reliability improvements
  • Fewer out of memory errors when indexing large attachments
  • Photos now display right side up when inserted into a page
  • New Estonian, Icelandic and Slovenian language packs.


Release Notes
6.4
  • Easier access to unpublished work
  • New draft and unpublished changes lozenge to remind you about unfinished work
  • Page history now shows both the avatar and name of the people who edited a version
Release Notes
6.5
  • Super simple database setup and configuration for new sites
  • More stability and reliability improvements
Release Notes
6.6
  • New Czech, Dutch, Hungarian, Polish, Slovak and Swedish language packs.
  • Ability to deploy Confluence Data Center in Azure
  • Restore administrator rights using recovery mode

6.6 is an Enterprise release. Learn more 

Release Notes
6.7
  • Mentioning people just got smarter (and faster)
  • Confluence gets a fresh new look with new colour scheme, fonts and icons
  • YAML syntax highlighting for the Code block macro
Release Notes
6.8
  • Confluence Server mobile app for iOS and Android!
  • Improvements to request access
  • More performance and stability improvements
Release Notes
6.9
  • Simpler options for publishing pages, or discarding changes.
  • Delete an unpublished page from within the editor.
Release Notes
6.10
  • Read-only mode for site maintenance in Data Center
  • Search improvements for everyone
Release Notes
6.11
  • Edit just about any attached file, then save it back to Confluence
  • Generate support zips via REST, including from multiple Data Center nodes
Release Notes
6.12
  • Simpler Synchrony set up for Confluence Data Center
  • Data Center PDF exports are now handled by the external process pool
  • Generate support zips on any node in Confluence Data Center
  • Easily distribute the Atlassian Companion app with the new Microsoft Installer
Release Notes

Critical bug fixes

6.0

Summary
Loading...
Refresh

All 6.0.x bug fixes
6.1

Summary
Loading...
Refresh

All 6.1.x bug fixes
6.2

Summary
Loading...
Refresh

All 6.2.x bug fixes
6.3

Summary
Loading...
Refresh

All 6.3 bug fixes
6.4

Summary
Loading...
Refresh

All 6.4.x bug fixes
6.5

Summary
Loading...
Refresh

All 6.5.x bug fixes
6.6*

6.6 is a designated Enterprise 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.6.x bug fixes
6.7

Summary
Loading...
Refresh

All 6.7.x bug fixes
6.8

Summary
Loading...
Refresh

All 6.8.x bug fixes
6.9

Summary
Loading...
Refresh

All 6.9.x bug fixes
6.10

Summary
Loading...
Refresh

All 6.10.x bug fixes
6.11

Summary
Loading...
Refresh

All 6.11.x bug fixes
6.12

Summary
Loading...
Refresh

All 6.12.x bug fixes

Supported platforms changes

6.0

Ended support for:

  • Internet Explorer 10
  • MySQL 5.5
  • 32-bit installers for Linux or Windows (you can still upgrade in 32-bit environments, you'll just need to use the zip/archive file method)
Supported Platforms
6.1

No changes

Supported Platforms
6.2

No changes

Supported Platforms
6.3

Ended support for:

  • Oracle Solaris

Added support for:

  • PostgreSQL 9.6
  • MySQL 5.7
Supported Platforms
6.4 No changes Supported Platforms
6.5 No changes Supported Platforms
6.6 No changes

Supported Platforms

6.7 No changes Supported Platforms
6.8

Ended support for:

  • PostgreSQL 9.2
Supported Platforms
6.9

Added support for:

  • IPv6
Supported Platforms
6.10

Added support for:

  • Microsoft SQL Server 2016
Supported Platforms
6.11

Added support for:

  • Oracle 12c Release 2
  • Microsoft SQL Server 2017
Supported Platforms
6.12 No changes Supported 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.0

Important notes:

  • Documentation theme will be removed
  • Space jump macro will be removed
  • No option to use the old (Confluence 5.8 and earlier) style dashboard
  • Personal drafts are no longer editable

Known issues:

  • If you plan to use collaborative editing, we recommend skipping Confluence 6.0 and upgrading directly to Confluence 6.1 or later for an easier setup process, especially if you use a reverse proxy or SSL.
  • If you've been using Confluence since version 2.4 or earlier (legends!) you should check the hibernate dialect in <confluence-home>/confluence.cfg.xml file before upgrading to Confluence 6.0 to avoid this error

Security advisory:

Upgrade Notes
6.1

Important notes:

  • There are additional memory, CPU and database requirements if you plan to use collaborative editing.
  • We recommend running Confluence on a minimum 4 core hardware
  • To reduce out of memory errors, the page index macro now has a page limit

Known issues:

  • Oracle users must upgrade their driver to 12.2.0.x before upgrading to Confluence 6.1 or later to avoid this issue.
Upgrade Notes
6.2

Important notes:

  • 'Link to this page' has moved to the share button
Upgrade Notes
6.3

Important notes:

  • The maximum number of people who can edit a page simultaneously is now limited to 12
  • New database driver recommendations
Upgrade Notes
6.4

Important notes:

  • Post-upgrade task to index drafts and unpublished changes may take some time in large sites with lots of unpublished content
  • Database driver changes for Microsoft SQL Server

Known issues:

  • Some fonts that Confluence relies on are not available in older Linux distributions. See this article for what to do. 
Upgrade Notes
6.5

Important notes:

  • Attachment indexing improvements may have an impact on the size and number of files in your attachments directory.
  • Changes to how we handle permissions when problems detected in the ancestor table. You may want to rebuild the ancestor table after upgrading to ensure you're not affected.
  • If you're using SQL Server, consider switching to the new driver.
Upgrade Notes
6.6

Important notes:

  • If you're still using the jTDS driver to connect to Microsoft SQL Server, we'll switch you to the new driver automatically. If this fails because you're using a datasource or other problem, see this article for what to do.

6.6 is an Enterprise release. Learn more 

Upgrade Notes
6.7

Important notes:

  • Confluence gets a new color scheme in this release. If you've customized the color scheme (globally or in individual spaces), we won't change any of the colors you've specified.  We'll only update any colors that you left unchanged.
  • New health check to confirm that the size of your HTTP thread pool (MaxThreads) is not greater than your database connection pool.
Upgrade Notes
6.8

Important notes:

  • To use the Confluence mobile app, your site must use HTTPS, have a certificate from a trusted Certificate Authority, and your proxy must allow TLS1.2 traffic.
  • If your site is not accessible on the public internet, people will need to be connected to your network or VPN when using the app.  
Upgrade Notes
6.9

Important notes:

  • When running Confluence in an IPv6 environment you need to still allow IPv4 traffic, and there are a number of places where you will need to use a fully qualified domain name, rather than a raw IPv6 address (for example when connecting to a database).
Upgrade Notes
6.10

Important notes:

  • This release bundles Apache Tomcat 9. Some options added in this Tomcat version are not yet supported in Confluence, including HTTP/2 and multiple TLS virtual hosts for a single connector with each virtual host supporting multiple certificates.
Upgrade Notes
6.11

Important notes:

  • The existing Edit with Office option has been replaced with a new feature that allows users to edit any type of file. To edit, users will need to download and install the Atlassian Companion app and have it running in the background.
  • We've made a change to how tables that contain large images are resized when exporting pages to PDF.
  • Scheduled XML daily backup is now disabled by default for sites with a Data Center license.
  • A new diagnostics feature is coming soon. You may see some new messages in your log files. No action is required for these messages.
Upgrade Notes
6.12

Important notes:

  • Data Center admins can now choose to let Confluence manage Synchrony, as in Confluence Server. If you choose this option, you'll need to allow an additional 2GB RAM for the Synchrony process on every Confluence node.
  • PDF export is now handled by the external process pool in Data Center.
  • Add-ons have been renamed to "Apps"
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 6.x version at any time! Check the upgrade notes above to make sure everything is compatible, and you're prepared for the transition.

Upgrading from 5.10 or earlier

It's time to get up-to-date! Confluence 5.10 and earlier are no longer supported and Confluence 6.0 will be out of support in November 2018. For more details, see our End of Life Policy.

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 6

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

Upgrade to 5.0.3 then upgrade to the latest version of Confluence 6.

4.0 to 4.3 

Upgrade to 5.10.x then upgrade to the latest version of Confluence 6.

5.0 to 6.x

Upgrade directly to the latest version of Confluence 6.

(warning)  Before you begin, it's critical that you follow all of the steps in Upgrading Confluence. Confluence 6.0 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.