Updated: 16 November 2026 · Applies to: CloudLinux OS with MySQL Governor on cPanel and WHM (commands according to CloudLinux's documentation; CloudLinux is licensed per server and was not tested here)

Once CloudLinux's MySQL Governor is installed on a cPanel server, MySQL Governor owns the database packages: upgrade or change MySQL and MariaDB with mysqlgovernor.py, not with WHM's MySQL/MariaDB upgrade screen. During mysqlgovernor.py --install, CloudLinux writes /var/cpanel/rpm.versions.d/cloudlinux.versions, which tells cPanel to stop managing the MySQL packages.

1. Back up first

CloudLinux asks for a full backup of every database, including the system tables, before any version change. Changing versions alters the system table structure, and a failed change without a backup can lose data.

According to CloudLinux, on cPanel you should first stop cPanel from restarting MySQL while you work:

whmapi1 configureservice service=mysql enabled=1 monitored=0

MySQL Governor 1.2-115 and later include a backup script:

/usr/share/lve/dbgovernor/scripts/mysql_backup.sh

When you are done, turn monitoring back on:

whmapi1 configureservice service=mysql enabled=1 monitored=1

2. Change the MySQL or MariaDB version

Run both commands as root. The first selects the target version, the second installs it:

/usr/share/lve/dbgovernor/mysqlgovernor.py --mysql-version=mariadb1011
/usr/share/lve/dbgovernor/mysqlgovernor.py --install

Replace mariadb1011 with the version you need. Values listed by CloudLinux include:

  • mysql57, mysql80 (MySQL Governor 1.2-37 or later), mysql84 (1.2-129 or later)
  • mariadb105 (1.2-62 or later), mariadb106 (1.2-76 or later), mariadb1011 (1.2-103 or later), mariadb1104 (1.2-122 or later, not on CloudLinux OS 7)
  • auto: the default version for your OS release or cPanel settings

According to CloudLinux, MySQL 5.1 and 5.5 and MariaDB 5.5, 10.0 and 10.1 are deprecated, and MySQL 5.6 works only on CloudLinux OS 7 and 8.

Rules to follow when you upgrade

  • Pick a version cPanel supports. According to CloudLinux, cPanel does not support MariaDB 10.4 on any CloudLinux OS version, and MariaDB 10.11 is not available to cPanel on CloudLinux OS 7.
  • Upgrade one step at a time. CloudLinux recommends upgrading in sequence, for example 10.3 to 10.5 (skipping 10.4 on cPanel), then 10.5 to 10.6.
  • Never go from MySQL 8 to MariaDB. CloudLinux warns this is not supported and breaks the database server.
  • Do not downgrade. CloudLinux does not recommend downgrading from MySQL 5.6 or MariaDB 10.x.
  • Rebuild Apache afterwards on cPanel, as CloudLinux advises after a version change.

3. Check that cPanel is not managing MySQL

Confirm the file MySQL Governor created:

cat /var/cpanel/rpm.versions.d/cloudlinux.versions

According to CloudLinux, if that file is missing, or you have your own MySQL entries in local.versions, mark the MySQL packages as unmanaged yourself, one line per package group that applies to you, for example:

/usr/local/cpanel/scripts/update_local_rpm_versions --edit target_settings.MySQL56 unmanaged

CloudLinux's article lists the same command for MySQL50, MySQL51, MySQL55, MySQL56 and MariaDB100.

Removing MySQL Governor and giving MySQL back to cPanel

To remove MySQL Governor, CloudLinux gives this command. It installs the original MySQL server and removes the Governor:

/usr/share/lve/dbgovernor/mysqlgovernor.py --delete

Then remove the unmanaged entries you added, for example:

/usr/local/cpanel/scripts/update_local_rpm_versions --del target_settings.MySQL56

and let cPanel take over the packages again with a forced update:

/scripts/upcp --force

If something goes wrong

If MySQL Governor reports Access denied for user 'root'@'localhost' in /var/log/dbgovernor-error.log, CloudLinux says to set valid login details in the connector line of /etc/container/mysql-governor.xml, then restart the service:

service db_governor restart

For a database server that keeps crashing after a change, see MySQL/MariaDB crashes and restarts often on cPanel server. If you would rather not run a database upgrade on a live server yourself, our cPanel server management team can do it for you.

Official documentation: CloudLinux MySQL Governor and Change MySQL version.

Related services

KVM VPS hosting

NVMe SSD and full root access, with Free Basic Managed Support.

Unmanaged dedicated servers

full root access and free IPMI KVM, with Free Basic Managed Support.

Managed dedicated servers

our engineers look after the server for you, from $135 a month.

Was this answer helpful?

Still stuck? Open a ticket