**This is an old revision of the document!**
cPanel Installation Guide
In order to run the cPanel software you must first be running a supported OS. cPanel lists their supported operating systems on their website at http://www.cpanel.net. Although there are many to choose from not every OS listed works flawlessly. If you're looking to have the least amount of problems and ease of administration we highly recommend you choose CentOS as your distro. CentOS is a recompile of RedHat Enterprise, and our research has shown that CentOS is the most widely used and easily supported distro when running cPanel. Note: cPanel currently does not support distributions other than CentOS, RHEL, & FreeBSD. Please be aware of this when installing your OS!
cPanel also recommends that the server it is being installed on is a clean and fresh install. This means that if you previously had done any configuring or ran another control panel software that they recommend you reinstall the server.
cPanel has made the installation process a simple one and only takes a few commands to get the install going. Most Many of these steps can be omitted depending on how you deployed your OS, but we have been verbose here to ensure all pre-requisites are satisfied. Below are the steps:
- Log into your server as root via the console or SSH. If you are installing cPanel via your VPS console, please see our guide here on using your VPS console.
- Ensure your resolvers are working by trying to resolve cpanel.net
<sxh plain> nslookup cpanel.net</sxh>
- If nslookup does not work, giving a 'command not found' error, you can use yum to install the necessary packages:
<sxh plain> yum install bind-utils.i386</sxh>
- If you get an error about not being able to resolve the host, you need to edit your /etc/resolv.conf and add proper resolvers. For servers in our network, the following command will suffice. If you are not in out datacenter, you will need to find out your host's DNS info:
<sxh plain> echo -e “nameserver 220.127.116.11\nnameserver 18.104.22.168”
- Satisfy cPanel's pre-requisites:
yum -y install wget perl screen
- Download cPanel's installer:
- Start a screen session so you can resume the cPanel install at a later time to check on it's status if you close the window or lose connection:
screen -S cpanel_install
- To resume the screen if you are disconnected:
screen -r cpanel_install
- Now run the installer using sh or bash:
he installer is now running and may take a hour to two depending on your servers hardware, OS, connection speed, etc.