How to install CloudLinux on cPanel

CloudLinux is available to use with your cPanel account. This guide will show you step by step how to correctly install both.

- Please note this tutorial is based on a fresh installation - if you are upgrading an existing installation, please backup the databases before continuing! - 

Before beginning, please make sure that you have a cPanel account. If you haven't already purchased one, you can browse our cPanel page for the one that fits your needs or buy one of our hosting packages that come with cPanel included.

Before the installation, there are a few pre-requirements needed in order to run smoothly. Enter the following command into your terminal:

yum upgrade -y && yum install wget curl nano -y;

Installing cPanel

cPanel is available on several operating systems, including CentOS and Red Hat Enterprise Linux. For this tutorial, we'll be using CentOS 7 (64-bit), therefore your installation might be different from what is provided. 

Now let's install cPanel.

Check your hostname (Some VPS providers don't apply the full hostname you provided). It should look something like:

Next, enter

nano -w /etc/hostname

and set it to something like:

After that, enter

nano /etc/sysconfig/network

and set it to something like:


You can also set it to:


Next, make sure nano /etc/hosts has just this for your IP address:

Once finished, you will need to reboot your server:


If that doesn't fix it, you might need to re-install the OS.

Now you can finally install cPanel:

cd /home && curl -o latest -L && sh latest

Installing CloudLinux

Now we need to install CloudLinux:

First, download the installer. You can do this by going to the official CloudLinux website or typing in:


Make sure that you have an active CloudLinux license. If you don't, feel free to buy one here (we issue licenses via IP).

Go ahead and activate CloudLinux:

sh cldeploy -i

Then reboot your server once more:


If you are using OpenVZ or Virtuozzo, you will be limited to just CageFS, PHP Selector & Max entry processes because these two virtualizations are in Beta testing at this moment in time (3rd July 2018) and only work on CentOS 6. You can find more information here: This is very complex and is recommended only for experts.

Now we need to install CloudLinux CageFS:

yum install cagefs -y
/usr/sbin/cagefsctl --init

Next we need Alt-PHP (PHP Selector):

yum groupinstall alt-php -y && yum update cagefs lvemanager -y

Installing the MySQL Governor

cPanel ships with MySQL 5.6.x by default, however, we'll show you how to change it if you want to move to MariaDB. If you want to keep the default MySQL, simply skip this part and jump to the "Install MySQL Governor on MySQL 5.6" section.

Upgrade MySQL to MariaDB:

First, go to

Software >> MySQL/MariaDB Upgrade

and select "MariaDB 10.0". You can use the GA MariaDB 10.1 if you want. Once you've clicked "Next" you will have to check two boxes and then hit "Continue". You can then select on "Unattended Upgrade" and wait for it to be completed. Now we need to install the MySQL Governor:

yum install governor-mysql -y
/usr/share/lve/dbgovernor/db-select-mysql --mysql-version=mariadb100

If you selected the GA MariaDB 10.1 you need to type this in:

/usr/share/lve/dbgovernor/db-select-mysql --mysql-version=mariadb101
/usr/share/lve/dbgovernor/ --install

Install MySQL Governor on MySQL 5.6

yum install governor-mysql -y
/usr/share/lve/dbgovernor/ --install

You should now be able to run CloudLinux on a cPanel server.

If you still have questions or concerns, feel free to contact us by opening a support ticket or by using our live chat feature.
  • installer, cPanel, install, CloudLinux
  • 7 Users Found This Useful
Was this answer helpful?

Related Articles

 How to install CloudLinux on DirectAdmin

CloudLinux is now available on DirectAdmin. Before you begin, however, there are a few things...

 What is CloudLinux?

In shared web hosting, the most common reason for downtime is a single account compromising...

 Everything you need to know about CloudLinux and server resource limits

What is Cloud Linux In shared web hosting, the most common reason for downtime is a single...

 Official CloudLinux Documentation

CloudLinux OS improves server stability, density, and security of your servers by partitioning...