import Intro from '/docs/snippets/breaking-change-page-intro.md'
import MigrationIntro from '/docs/snippets/breaking-change-page-migration-intro.md'

Only the mysql2 package is supported for the MySQL client#

Strapi 5 only supports the mysql2 package for MySQL databases and requires the client configuration option to be set to mysql.

Strapi 5 can only use the mysql2 package for MySQL databases, and the client value for it must be set to mysql.

Breaking change description#

In Strapi v4

The database configuration client option for MySQL databases accepts several values such as mysql and mysql2.

In Strapi 5

The database configuration client option for MySQL database only accepts mysql.

Migration#

Notes#

• Strapi 5 uses the mysql2 package for SQLite databases under the hood and rewrites the mysql option as mysql2 for Knex.
• Additional information about database clients and configuration can be found in the database configuration documentation.
• Please also consider that MySQL v8 is the minimum required version for Strapi 5 (see the related breaking change entry).

Manual procedure#

No manual migration should be required as codemods from the upgrade tool will handle this change.