Page tree
Skip to end of metadata
Go to start of metadata


WHMCS offers an all-in-one billing and automation platform that automates all aspects of a web hosting business. This document describes how to install WHMCS on your WHM account.

Server Setup

Before you install WHMCS, you will need to install ionCube® and set up your database. 

Install ionCube

To install ionCube, follow the directions in our PHP Loader: ionCube 6 documentation.

Set up your database

After you install ionCube, follow the instructions in our MySQL Database Wizard documentation to set up your database.

Install WHMCS

Download WHMCS.

To download WHMCS, perform the following steps:

  1. Visit the WHMCS Download website.
  2. Enter your license key.
  3. Click Validate & Download to download the .zip file.

Prepare the files for upload.

Before you upload the WHMCS files to your website, you will need to unzip the downloaded file and rename a configuration file. To do so, perform the following steps:

  1. Locate the downloaded .zip file on your computer.
  2. Unzip the contents of the .zip file to a folder on your computer.
  3. In the WHMCS folder, rename the file to configuration.php.

Upload the WHMCS folder to your website.

Upload the WHMCS folder to your website. You may rename the folder, if desired.


If the system returns an error, upload the file in binary mode.


You cannot use the name admin for the WHMCS folder. The administration directory uses admin as a name.

Run the WHMCS Installer

To run the WHMCS installer, perform the following steps:

  1. To start the installation process, visit, where represents your domain. If you uploaded the WHMCS files to a directory other than public_html, paste that path after your domain name in the URL.

  2. Follow the instructions to complete the installation.

Change permissions on the directories.

To change permissions on the directories, run the following commands:

chmod 400 configuration.php
chmod 777 attachments
chmod 777 downloads
chmod 777 templates_c

Delete the install directory.

To delete the install directory, perform the following steps.

  1. Navigate to the directory where you uploaded WHMCS.

  2. Delete the install directory.

Log in to your WHMCS account.

Log in to your WHMCS account with your license key.

Additional documentation