MySQL v5 is not supported in Strapi v5 anymore

In Strapi 5, MySQL version 5 is not supported.

This page is part of the breaking changes database and provides information about the breaking change and additional instructions to migrate from Strapi v4 to Strapi 5.

🔌 Is this breaking change affecting plugins?	No

🤖 Is this breaking change automatically handled by a codemod?	No

Breaking change description

In Strapi v4

MySQL v5 is supported.

In Strapi 5

MySQL v5 is not supported anymore.
MySQL v8 is the minimum required version.

Migration

This section regroups useful notes and procedures about the introduced breaking change.

Notes

• The CLI installation guide lists the databases supported by Strapi 5.
• Please also consider that only the mysql2 package can be used with Strapi 5 for MySQL databases (see the related breaking change entry).

Migration procedure

No manual migration is required for the codebase of your Strapi application. Connection information will probably stay the same as in Strapi v4.

However, to use Strapi v5, you must upgrade your MySQL database to version 8.0 (see additional information in the official MySQL documentation).