Knowledge base

Products

See all

Resources

Cloud

_upgrade_preupgradechecks

_UpgradeGuides

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

Check the Upgrade Notes for the version you plan to upgrade to (and any in between).
Go to Administration menu , then General Configuration > Plan your upgrade then select the version you want to upgrade to. This will run some pre-upgrade checks.
Go to Administration menu , then 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 menu , then 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.
Go to Administration menu then Manage apps and scroll down to the Confluence Update Check to check the compatibility of your Marketplace apps.
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 Apr 4, 2025

Was this helpful?

Yes Provide feedback about this article

Powered by Confluence and Scroll Viewport.