Startup check: MySQL database version check

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

The MySQL database health check verifies that your JIRA instance is using a supported MySQL database. Using a supported database ensures JIRA's data integrity and avoids unexpected behaviour when using JIRA applications.

Solution

Impact

We only test each JIRA release with supported databases, so unsupported databases are not tested and there's no guarantee they'll work. Using an unsupported database is considered high risk because if there are problems with the database or unexpected behaviour in the application, our Support may not be able to help you fix it.

Resolution

You need to migrate your data to a supported MySQL database version. To find out what versions of MySQL are supported, refer to the link below corresponding to the version of JIRA you're upgrading to. We strongly recommend trying this on a staging / test server first, in case you encounter problems during the migration process.

Updated on April 8, 2025

Still need help?

The Atlassian Community is here for you.