Install using DNF

Installation method

This guide documents the standard operating system (OS) installation on Red Hat Package Manager (RPM)-based systems. Supported distributions include Red Hat Enterprise Linux (RHEL), CentOS, and Rocky Linux. The procedure uses Dandified YUM (DNF). The Percona Server for MySQL software repositories and the [Percona downloads] page provide the required packages. DNF replaces YUM on RHEL 8 and later. The yum commands continue to work because the system aliases them to dnf.

Containerized deployments use separate guides:

• For Docker containers, see Running Percona Server for MySQL in a Docker Container.

• For Kubernetes deployments, see Percona Operator for MySQL based on Percona Server for MySQL or Percona Operator for MySQL based on Percona XtraDB Cluster.

The percona-release tool is a command-line utility that simplifies the management and installation of Percona software packages, providing access to the latest versions and ensuring consistency across environments. For more information, refer to the Percona Software Repositories Documentation.

We gather Telemetry data in the Percona packages and Docker images.

Review Get help from Percona for ways that we can work with you.

Prerequisites

Review the following requirements before you start the installation.

Required permissions

Package installation and service configuration require sudo access or root access. The commands in this guide use sudo. You can run the commands as the root user instead.

Package verification

Percona signs all packages with GNU Privacy Guard (GPG) keys. The installation process installs the Percona GPG key and verifies signatures automatically. You can verify packages manually when required.

Security note

Always download packages from the official Percona repositories to confirm authenticity.

Limitations

RHEL 8 and later systems enable the MySQL module by default. The module hides the Percona-provided packages. Disable the module to make the Percona packages visible.

Checking the MySQL module

RHEL 8 and later systems enable the MySQL module by default. The module can hide or conflict with Percona packages. The first installation step in the following section checks whether the module is enabled. An [e] marker indicates that you must disable the module before proceeding. A [d] marker indicates the default stream and allows you to proceed.

Install using DNF (RHEL 8 and later)

Standard OS installation

The following steps install Percona Server for MySQL directly on the host operating system using DNF. The procedure applies to standard OS installations, not to Kubernetes pods or containerized environments.

For scripted automation, see Non-interactive DNF installation for Percona Server for MySQL 9.7.

All commands in this guide use sudo for privilege elevation. Follow these steps:

1. Verify whether the MySQL module is enabled on your system:

   sudo dnf module list mysql
   

   Expected output

   Rocky Linux 9 - BaseOS                     2.2 MB/s | 2.6 MB     00:01
   Rocky Linux 9 - AppStream                  3.7 MB/s | 8.2 MB     00:02
   Rocky Linux 9 - Extras                      35 kB/s |  18 kB     00:00
   Rocky Linux 9 - AppStream
   Name       Stream      Profiles                            Summary
   mysql      8.4         api, client, filter, server [d]     MySQL Module
   
   Hint: [d]efault, [e]nabled, [x]disabled, [i]nstalled
   

   The [d] marker next to the server profile indicates the default stream. A module is enabled only when an [e] marker is present. An [e] marker indicates that the module is active.

2. Disable the MySQL module if step 1 lists the module as [e]-enabled. The MySQL module conflicts with Percona packages. Run the following command:

   sudo dnf module disable mysql
   

   Expected output

   Last metadata expiration check: 0:33:11 ago on Fri Aug 29 14:37:35 2025.
   Dependencies resolved.
   Nothing to do.
   Complete!
   

   The dnf module disable command disables the MySQL module. When the module is not enabled, the command returns Nothing to do. This output is expected. Proceed with the installation.

3. Install the Percona repository package:

   sudo dnf install https://repo.percona.com/yum/percona-release-latest.noarch.rpm
   

   Expected output

   Last metadata expiration check: 1:04:21 ago on Fri Aug 29 14:37:35 2025.
   percona-release-latest.noarch.rpm           69 kB/s |  28 kB     00:00    
   Dependencies resolved.
   ===========================================================================
   Package               Architecture Version       Repository          Size
   ===========================================================================
   Installing:
   percona-release       noarch       1.0-32        @commandline        28 k
   
   Transaction Summary
   ===========================================================================
   Install  1 Package
   ...
   Installed:
   percona-release-1.0-32.noarch                                            
   
   Complete!
   

   If this step fails, take the following actions:

   • Check your internet connection.

   • Verify that the URL is accessible: curl -I https://repo.percona.com/yum/percona-release-latest.noarch.rpm

   • Confirm that the system has sufficient disk space: df -h

4. Enable the Percona Server for MySQL repository:

   sudo percona-release enable-only ps-97-lts release
   

   Expected output

   * Disabling all Percona Repositories
   * Enabling the Percona Server for MySQL - PS 9.7- repository
   <*> All done!
   

   If this step fails, take the following actions:

   • Check that percona-release is installed: which percona-release

   • Verify that the package name is correct for your version.

   • Review the command output for error messages.

5. Install the server package:

   The package manager does not prompt for a root password on a fresh RPM install. After installation, set the password using the temporary password in the error log. For automation, see Non-interactive DNF installation for Percona Server for MySQL 9.7.

   sudo dnf install percona-server-server
   

   Expected output

   Percona Release release/noarch YUM reposit 6.0 kB/s | 2.5 kB     00:00
   Percona Server for MySQL - PS 9.7- release 1.5 MB/s | 2.4 MB     00:01
   Percona Telemetry release/aarch64 YUM repo 6.8 kB/s | 2.7 kB     00:00
   Dependencies resolved.
   ===========================================================================
   Package                 Arch    Version                  Repository  Size
   ===========================================================================
   Installing:
   percona-server-server   aarch64 9.7.0-0.el9              ps-97-lts-release-aarch64
   ...
   systemd-252-51.el9_6.1.aarch64
   systemd-pam-252-51.el9_6.1.aarch64
   systemd-rpm-macros-252-51.el9_6.1.noarch
   
   Complete!
   

   If this step fails, take the following actions:

   • List available packages: dnf search percona-server.

   • Verify that the repository configuration is correct.

   • Check for package conflicts with existing MySQL installations.

   • Review error messages for specific issues.

See Configuring Percona repositories with percona-release for more information.

Post-installation configuration

Percona Server for MySQL 9.7.x comes with the MyRocks storage engine. This storage engine is installed as a plugin. For information on installing and configuring MyRocks, refer to the Percona MyRocks Installation Guide.

Next steps

After installation completes, see Post-installation for steps to configure and secure your Percona Server for MySQL installation.

Related installation topics

• Non-interactive DNF installation for Percona Server for MySQL 9.7: unattended installs, temporary password handling, and percona-release flags

• Optional steps after repository install for Percona Server for MySQL 9.7: Percona Toolkit UDFs and the testing repository

Additional information

The following sections describe certifications, hardware architecture support, and platform compatibility.

Red Hat certified

Red Hat certifies Percona Server for MySQL on Red Hat Enterprise Linux 8. The certification confirms operating system interoperability and adherence to common security practices. Percona Server appears in the Red Hat Ecosystem Catalog.

ARM support

The RPM builds contain Advanced RISC Machine (ARM) packages that use the aarch64.rpm extension.

Supported platforms

The Percona Software and Platform Lifecycle document lists supported platforms, products, and versions.