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

Introduction

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

For example, if you'd like to use any version of MariaDB, it must be selected before you start the installation of cPanel, as you cannot convert from MySQL 8.0 to any version of MariaDB.

Procedure

On a brand new server that does not have cPanel installed, create the following file:

mkdir /root/cpanel_profile

touch /root/cpanel_profile/cpanel.config

You'll then add one of the following configurations to the file to specify your desired version of MySQL or MariaDB, then run the installer as you normally would.

You may select any version currently supported on your operating system.

Available Options

• MySQL 8

  mysql-version=8.0

• MariaDB 10.6

  mysql-version=10.6

• MariaDB 10.5

  mysql-version=10.5

• MariaDB 10.6

  mysql-version=10.6

• MariaDB 10.11

  mysql-version=10.11

Please note, 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