How to install WHMCS

66 / 100

In order to install the WHMCS billing platform the license key is required.

There are two ways to install the WHMCS billing platform:

1. WHMCS installation via the Softaculous script installer

2.  Manual WHMCS installation

WHMCS installation via the Softaculous script installer

You can install WHMCS with the help of the Softaculous script installer if you have one in your cPanel control panel.

Manual WHMCS installation

The installation files provided in this guide can be used for the manual WHMCS installation.


Installing Ioncube

Please take into account that WHMCS is encrypted using Ioncube to protect the source code. If you use the cPanel control panel, you already have Ioncube enabled on your server. If you find you do need to install Ioncube on your server, then you can find out how to do this in this Ioncube Installation Tutorial.

Installing WHMCS

The following steps will guide you through the process:

1. Unzip the contents of the zip file to a folder on your computer
2. Rename the file to configuration.php
3. Upload the entire whmcs folder to your website. If you experience problems, try uploading it in the binary mode
4. Next, you can rename the folder to whatever you like (billing, clients, etc…).
5. Now visit the installation script at to run the installer process – if you get an Ioncube-related error message, see the installation Ioncube steps above
6. Follow the instructions on the screen to install which will involve setting file permissions as listed below, entering your license key and setting up your primary admin account
7. When complete, delete the install folder from your web server and CHMOD the configuration.php file back to 644

Required file and folders permissions (unless your php is suPHP or PHPSuExec):

/configuration.php          CHMOD 777 Writeable

/attachments                CHMOD 777 Writeable

/downloads                  CHMOD 777 Writeable

/templates_c                CHMOD 777 Writeable

Post Installation Suggested Steps

After the installation is completed, we recommend that you go through and configure your new WHMCS system in the following order:

1. Log into the Admin Area and configure your General Settings (Setup > General Settings).
2. Set up your Payment Gateways (Set up > Payment Gateways).
3. Set up your Products & Services (Set up > Products and Services ).
4. Configure your Domain Pricing (Set up > Domain Pricing ).
5. Set up your Support Ticket Departments (Setup > Support Departments ).
6. Set up email piping so you can manage tickets using the WHMCS Support Desk – for full instructions on this, please see the Email Piping article.
7. Ensure the WHMCS Cron Job is set up and configure automated tasks (Set up > Automation Settings).
8. Place some test orders on your website to check everything works as expected.