How to customize the version of MySQL or MariaDB used when installing cPanel

Introduction

When installing cPanel, many default options, including the database server version, are set. If a version other than the default is desired, this must be configured before installing cPanel.

Procedure

1. Access the server's command line as the 'root' user via SSH.
2. Create the /root/cpanel_profile folder.

   mkdir /root/cpanel_profile

3. Create the /root/cpanel_profile/cpanel.config file.

   touch /root/cpanel_profile/cpanel.config

4. Open cpanel.config in your preferred text editor.
5. Add a line to set mysql-version to the value of the desired version.
   • MySQL 8

     mysql-version=8.0

   • MariaDB 10.5

     mysql-version=10.5

   • MariaDB 10.6

     mysql-version=10.6

   • MariaDB 10.11

     mysql-version=10.11

   Selecting a version that is not supported on your operating system will result in cPanel failing to install.

Additional Resources

What versions of MySQL and MariaDB does cPanel support?

Customize Your cPanel Installation | cPanel Docs