Products

See all

Resources

_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
Error rendering macro 'excerpt-include'
User 'null' does not have permission to view the page.
> Plan your upgrade then select the version you want to upgrade to. This will run some pre-upgrade checks.
Go to
Error rendering macro 'excerpt-include'
User 'null' does not have permission to view the page.
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
Error rendering macro 'excerpt-include'
User 'null' does not have permission to view the page.
> License Details and follow the prompts to renew your license.

Still using the embedded database?

If you are using the embedded (trial) database you should migrate to a different database before upgrading. See Embedded H2 Database for more information.

Database character encoding incorrect?

Database character encoding must be set to UTF+8 (or AL32UTF8 for Oracle databases). You will not be able to upgrade to current Confluence versions unless you have the correct character encoding.
Go to
Error rendering macro 'excerpt-include'
User 'null' does not have permission to view the page.
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 1, 2021

Was this helpful?

Yes Provide feedback about this article

Powered by Confluence and Scroll Viewport.