Skip to content

TokuDB changes in Percona Server for MySQL by version


Percona Server for MySQL 8.0.28-19 removes the TokuDB storage engine and this storage engine is no longer supported.

We have removed the storage engine from the installation packages and disabled the storage engine in our binary builds.


Percona Server for MySQL 8.0.26-16 includes the TokuDB storage engine plugins in the binary builds and packages but disables them.

The tokudb_enabled option and the tokudb_backup_enabled option control the state of the plugins and have a default setting of FALSE. The plugins fail to initialize and print a deprecation message if you attempt to load them.

We recommend migrating the data to the MyRocks storage engine

Set the tokudb_enabled and tokudb_backup_enabled options to TRUE in your my.cnf configuration file.

This action enables the plugins needed for migration.


# Enable TokuDB
# Enable TokuDB backup

After saving these changes, restart your server instance to apply the new settings. This restart is crucial since it initializes the plugins and prepares your system for migration to MyRocks.


The TokuDB storage engine was declared deprecated in Percona Server for MySQL 8.0. For more information, see the Percona blog post: Heads-Up: TokuDB Support Changes and Future Removal from Percona Server for MySQL 8.0.

Get expert help

If you need assistance, visit the community forum for comprehensive and free database knowledge, or contact our Percona Database Experts for professional support and services.

Last update: 2024-03-22