Installing Percona Server for MySQL 8 on Debian and Ubuntu

Ready-to-use packages are available from the Percona Server for MySQL software repositories and the Percona downloads   page.

Specific information on the supported platforms, products, and versions is described in Percona Software and Platform Lifecycle.

What’s in each DEB package?

Package Contains
percona-server-server The database server itself, the mysqld binary and associated files.
percona-server-common The files common to the server and client.
percona-server-client The command line client.
percona-server-dbg Debug symbols for the server.
percona-server-test The database test suite.
percona-server-source The server source.
libperconaserverclient21-dev Header files needed to compile software to use the client library.
libperconaserverclient21 The client shared library. The version is incremented when there is an ABI change that requires software using the client library to be recompiled or its source code modified.

Installing Percona Server for MySQL from Percona apt repository

Install GnuPG, the GNU Privacy Guard:

Fetch the repository packages from Percona web:

Install the downloaded package with dpkg. To do that, run the following commands as root or with sudo:

Once you install this package the Percona repositories should be added. You can check the repository setup in the/etc/apt/sources.list.d/percona-release.list file.

Enable the repository:

After that you can install the server package:


Percona Server for MySQL 8.0 comes with the TokuDB storage engine and MyRocks storage engine. These storage engines are installed as plugin.

For information on how to install and configure TokuDB, refer to the TokuDB Installation guide.

For information on how to install and configure MyRocks, refer to the Percona MyRocks Installation Guide guide.

The Percona Server for MySQL distribution contains several useful User Defined Functions (UDF) from Percona Toolkit. After the installation completes, run the following commands to create these functions:

For more details on the UDFs, see Percona Toolkit UDFS.

Percona apt Testing repository

Percona offers pre-release builds from the testing repository. To enable it, run percona-release with the testing argument. Run this command as root or by using the sudo command.

Apt-Pinning the packages

In some cases you might need to “pin” the selected packages to avoid the upgrades from the distribution repositories. You’ll need to make a new file /etc/apt/preferences.d/00percona.pref and add the following lines in it:

For more information about the pinning you can check the official debian wiki.

Installing Percona Server for MySQL using downloaded deb packages

Download the packages of the desired series for your architecture from the Percona downloads page. The easiest way is to download bundle which contains all the packages. The following example will download Percona Server for MySQL 8.0.13-3release packages for Debian 9.0 (stretch):

You should then unpack the bundle to get the packages:

After you unpack the bundle you should see the following packages:


Now, you can install Percona Server for MySQL using dpkg. Run this command as root or by using the sudo command

This will install all the packages from the bundle. Another option is to download/specify only the packages you need for running Percona Server for MySQL installation (libperconaserverclient21_8.0.13-3-1.stretch_amd64.deb, percona-server-client_8.0.13-3-1.stretch_amd64.deb, percona-server-common_8.0.13-3-1.stretch_amd64.deb, and percona-server-server_8.0.13-3-1.stretch_amd64.deb. Optionally, you can install percona-server-tokudb_8.0.13-3-1.stretch_amd64.deb if you want the TokuDB storage engine).

Note: Percona Server for MySQL 8.0 comes with the TokuDB storage engine. You can find more information on how to install and enable the TokuDB storage in the TokuDB Installation guide.

Running Percona Server for MySQL

Percona Server for MySQL stores the data files in /var/lib/mysql/ by default. You can find the configuration file that is used to manage Percona Server for MySQL in /etc/mysql/my.cnf.

Note :Debian and Ubuntu installation doesn’t automatically create a special debian-sys-maint user which can be used by the control scripts to control the Percona Server for MySQL mysqld and mysqld_safe services like it was the case with previous Percona Server for MySQL versions. If you still require this user you’ll need to create it manually.

Run the following commands as root or by using the sudo command

  1. Starting the service

    Percona Server for MySQL is started automatically after it gets installed unless it encounters errors during the installation process. You can also manually start it by running: service mysql start

  2. Confirming that service is running. You can check the service status by running: service mysql status
  3. Stopping the service

    You can stop the service by running: service mysql stop

  4. Restarting the service. service mysql restart

Note: Debian 9.0 (stretch) and Ubuntu 18.04 LTS (bionic) come with systemd as the default system and service manager. You can invoke all the above commands with systemctl instead of service. Currently both are supported.

Working with AppArmorFor information on AppArmor, see Working with AppArmor.

Uninstalling Percona Server for MySQL

To uninstall Percona Server for MySQL you’ll need to remove all the installed packages. Removing packages with apt-get removewill leave the configuration and data files. Removing the p ackages with apt-get purge will remove all the packages with configuration files and data files (all the databases). Depending on your needs you can choose which command better suits you.

  1. Stop the Percona Server for MySQL service: service mysql stop
  2. Remove the packages
    1. Remove the packages. This will leave the data files (databases, tables, logs, configuration, etc.) behind. In case you don’t need them you’ll need to remove them manually: apt-get remove percona-server*
    2. Purge the packages. NOTE: This will remove all the packages and delete all the data files (databases, tables, logs, etc.): apt-get purge percona-server*