_upgrade_preupgradechecks

_UpgradeGuides

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

  1. Check the Upgrade Notes for the version you plan to upgrade to (and any in between). 
      

  2. Go to Administration  > General Configuration > Plan your upgrade then select the version you want to upgrade to. This will run some pre-upgrade checks
     

  3. Go to Administration  > General Configuration > Troubleshooting and support tools to run the health check. 

    License expired?

    If the software maintenance period included in your license has expired you can keep using Confluence, but you'll need to renew before you can upgrade.

    Go to Administration  > General Configuration > License Details and follow the prompts to renew your license.

    Database character encoding incorrect?

    Database character encoding must be set to UTF8 (or UTF8MB4 for MySQL databases, or AL32UTF8 for Oracle databases). You will not be able to upgrade to the current Confluence versions unless you have the correct character encoding.

      

  4. Go to  Administration > Manage apps and scroll down to the Confluence Update Check to check the compatibility of your Marketplace apps.
       

  5. Choose the version you plan to upgrade to then hit Check.

    If you have incompatible add-ons...

    If your users rely on particular Marketplace apps, you may want to wait until they are compatible before upgrading Confluence. Vendors generally update their apps very soon after a major release.

    Good to know:

    • You can disable an app temporarily while you upgrade if it is not yet compatible.
    • Compatibility information for Atlassian Labs and other free apps is often not available immediatley after a new release. In many cases the app will still work, so give it a try in a test site before upgrading your production site.
Last modified on Nov 29, 2022

Was this helpful?

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