Installing cPanel and WHM

For cPanel/WHM version 11.24

Choosing a Server

ALERT! Important: cPanel and WHM cannot be installed on a production web server; you must use a server with a freshly installed operating system.

It is important to consider how many sites you plan to host with your web server. For example, if your server is going to host a lot of websites, each with its own set of email addresses and databases, your server’s requirements for processing power, disk space, and RAM will increase.

It is also important to consider what kind of web hosting you plan to do when choosing a server. While cPanel and WHM will run on the minimum requirements specified below, your server’s requirements may increase if you plan to host videos, music, or other high-volume websites such as blogs or forums.

Minimum Requirements

  • Pentium or AMD chipset at 266 MHz.
    • Both i386 and x64-86 architectures will work with cPanel.
  • 256 MB of RAM (1 GB minimum is recommended when hosting many accounts).
  • 10 GB free hard drive space (More is required to host multiple accounts).
  • A fresh installation of an operating system specified below.


Choosing an Operating System

We recommend using a Red Hat® or CentOS operating system in order to ensure the best possible experience with our software.

CentOS Red Hat Enterprise Linux
Free Paid
Community-supplied updates Updates from Red Hat
Community-supplied support Support from Red Hat
CentOS vs. Red Hat Operating Systems

You will need to determine which type of processor your server uses — i386 (32-bit), or x64-86 (64-bit), in order to know which operating system to install. (If you are unsure, research the processor online, or contact your vendor.) The recommended operating systems are:

  • Red Hat Enterprise Linux versions:
    • For i386 machines only: 2.1.
    • For x64-86 or i386 machines: 3, 4, or 5.
  • CentOS versions:
    • For i386 machines only: 3.x.
    • For x64-86 or i386 machines: 4.x, or 5.x.

  • Red Hat Linux distributions can be obtained at http://redhat.com.
  • A CentOS distribution can be obtained at http://www.centos.org.
    • You can also obtain download a free CentOS DVD ISO here. Upon its first reboot, this will install cPanel and WHM in the background.
    • To use this ISO, you must burn the image to a DVD. Then, insert the DVD into the server and turn it on.
  • FreeBSD® can be obtained at http://www.freebsd.org.

You will need to use a web-accessible computer to download the operating system and burn it to CD or DVD so that it can be installed on your server.

ALERT! Important: CentOS, Red Hat, and FreeBSD are the only operating systems supported by cPanel and WHM. No other OS is compatible.

A note about FreeBSD

While FreeBSD is supported, it is only recommended for system administrators who are familiar with it. FreeBSD can require a detailed manual configuration in order to run smoothly.

cPanel uses FreeBSD’s ports system for updates. When cPanel is installed, do not use binary packages (pkg_add). Use of both systems can cause major administration problems when dependencies are removed from one system without the other system being made aware. The ports used by cPanel come directly from FreeBSD's ports repository.

Port upgrades may require you to manually interact with the system to ensure it is functioning as expected. There are some issues we cannot solve automatically in a FreeBSD system.

For this reason, we ask those without FreeBSD administration experience to use Red Hat or CentOS. This will provide a better overall experience with our software.


Installing Your Operating System

When the operating system discs are placed in your server, you will be prompted to test the discs prior to running the installation. We highly recommend that you test the disc(s) before installing, as it could save time later, if a disc proves to be unreadable.

Before installing your OS, here are some points to consider:

  • You should install a minimal version of the operating system. All services that cPanel requires will be installed during the cPanel/WHM installation process. Installing services prior to the installation of cPanel/WHM will cause compatibility issues.
  • The minimal installation does, however, need to include a working package handler such as yum or apt-get (included in default installations of CentOS and Red Hat Enterprise Linux).
  • If possible, configure your Ethernet device with a static IP address and a fully qualified hostname during the operating system’s installation. This will minimize the amount of work you will need to do after the installation of the OS and cPanel software.
    • You will need to define the IP address, subnet address, and default gateway IP for your server. Your data center will be able to provide you with this information.

Install the OS, following the prompts and referring to the OS documentation when necessary.


Configuring your Operating System

You will be asked to configure a number of features prior to installing your operating system.

You will need to:

  1. Correctly partition your hard drive.
  2. Deactivate the firewall.
  3. Disable SELinux.

Disable SELinux Security Features

For a fully successful installation you should disable SELinux. When installing a Red Hat or CentOS distribution, you will be able to use the graphical interface to disable SELinux when configuring the operating system.

This can also be accomplished by editing /etc/selinux/config from the command line, and setting the SELINUX parameter to disabled with a text editor such as nano. The file should resemble the following text:

  • # This file controls the state of SELinux on the system.
  • # SELINUX= can take one of these three values:
  • # enforcing - SELinux security policy is enforced.
  • # permissive - SELinux prints warnings instead of enforcing.
  • # disabled - No SELinux policy is loaded.
  • SELINUX=disabled
  • # SELINUXTYPE= can take one of these two values:
  • # targeted - Only targeted network daemons are protected.
  • # strict - Full SELinux protection.
  • SELINUXTYPE=targeted

ALERT! Important: SELinux must remain disabled in order for WHM and cPanel to run on your web server. Ensure that the number sign (#) does not precede SELINUX=disabled. If this sign precedes this configuration option, this line will be ignored.

ALERT! Warning: Do not transfer the SELinux configuration file between computers as it may destroy the file’s integrity.

Recommended Partitions

Please note that these partitions pertain to Linux. When installing Linux, use an ext file system.

While each operating system provides a default partition setup, a simplified setup is recommended. The /tmp partition is created for security reasons.

Partition Name Size
/tmp 1 GB (1024 MB)
/ Grow to fill disk.
Partitioning Guide

In some cases it may be optimal to increase the number of partitions (especially on servers that use high volumes of email), as the number of files that the operating system can access per partition is limited.

ALERT! Note: Advanced partitioning information is available later in this guide.


Preparing to Install cPanel and WHM

Once you have successfully installed your operating system, you are ready to install WHM and cPanel. There are some basic steps to installing the cPanel software. You will need to:

  1. Access your server.
    • This can be done remotely if you do not have physical access.
  2. Check and configure some files.
  3. Run installation commands in a command line interface (see below).

Connecting to Your Server Remotely via SSH

To begin the WHM/cPanel installation process, a connection must be made from your computer to the server unless you have physical access to the server.

To begin in a *nix environment:

  1. Access the command line interface (using a terminal application).
  2. Type the following command: ssh root@$IP (where $IP is meant to represent your target server’s IP address.)
  3. Enter your server’s root password.

If you are installing cPanel from a Windows® computer, you should use PuTTy to connect to your server. You can visit the PuTTy site here for more details.

To begin using PuTTy:

  1. Download and install the client from the URL above.
  2. Open the client.
  3. Under the Sessions menu, input the IP address of the server.
    • Make sure that the SSH button is selected.
  4. Click Open.
  5. Use root as the login name.
  6. Enter the root password.

If the username and password were correctly entered, you should be logged into the server.

ALERT! Remember: Once you are logged into the server you will need to use the POSIX standardized commands to manipulate files on that server, regardless of whether you are using PuTTy or a native SSH client.


Obtaining a cPanel / WHM license

If a license for cPanel/WHM has not yet been obtained, you will need to obtain one for your IP address. You should acquire your license before you attempt to install cPanel.

ALERT! Note: We offer 15-day test licenses for no cost at http://www.cpanel.net/store.

You can obtain a license at http://www.cpanel.net/store.

Installing cPanel / WHM

To begin your installation, use the following commands:

  1. cd /home — Opens the directory /home.
  2. wget http://layer1.cpanel.net/latest — Fetches the latest installation file from the cPanel servers.
  3. sh latest — Opens and runs the installation files.
  4. /usr/local/cpanel/cpkeyclt — Activates your license after installation.


Configuring Your Network Connection

Red Hat and CentOS let you run the setup command to configure network connections. If you did not set up a static IP address for your server during the OS installation, you will need to define the IP address, subnet address, and default gateway IP for your server using the the setup tool. Your data center will be able to provide you with this information.

If you are using FreeBSD, you should consult that community’s documentation when configuring your server’s connection.

For information about obtaining IP addresses you may visit:

ALERT! Note: You should configure your Ethernet connection(s) when installing your operating system whenever possible.


Getting Started in WHM

To access the WHM interface:

  1. Type https:/IP:2087 in your preferred web browser.
    • IP is meant to stand for the IP address of your web server.
  2. Use root as the login name in the Name field.
  3. Enter the root password into the Password field.
  4. Click Log In.

  • For more details, see our documentation on the WHM Initial Setup wizard.
  • To set up cPanel accounts for your users, navigate to the WHM Create a New Account screen. cPanel allows your users to create email and FTP accounts, as well as perform other website management tasks.
Topic revision: r23 - 24 Aug 2010 - 13:50:42 - MelanieSeibert