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:
cpanel.yourdomain.com
Next, enter
nano -w /etc/hostname
and set it to something like:
cpanel.yourdomain.com
After that, enter
nano /etc/sysconfig/network
and set it to something like:
HOSTNAME="cpanel.yourdomain.com"
You can also set it to:
hostname cpanel.yourdomain.com
Next, make sure nano /etc/hosts
has just this for your IP address:
xxx.xxx.xxx.xx cpanel.yourdomain.com
Once finished, you will need to reboot your server:
reboot
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 https://securedownloads.cpanel.net/latest && 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:
wget https://repo.cloudlinux.com/cloudlinux/sources/cln/cldeploy
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:
reboot
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: http://docs.cloudlinux.com/index.html?virtuozzo_and_opz.envhtml. 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/mysqlgovernor.py --install
Install MySQL Governor on MySQL 5.6
yum install governor-mysql -y /usr/share/lve/dbgovernor/mysqlgovernor.py --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.