How to install WHMCS

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

Namecheap provides WHMCS licenses with Reseller Level 1 and Level 2, VPS, dedicated servers hosting plans at $8.00/mo. It is free of charge with Reseller Level 3 and 4 plans. WHMCS license is not available for Value, Professional, Ultimate and Business plans.

If you need one, feel free to contact our Billing Department via ticket system.

There are two ways how to install WHMCS billing platform:

  1. WHMCS installation via Softaculous script installer.

  2.  Manual WHMCS installation.

WHMCS installation via Softaculous script installer

You can install WHMCS with the help of Softaculous script installer if you have one in your cPanel control panel.  This video tutorial can be of help during WHMCS installation via Softuculous.

Manual WHMCS installation

The installation files below can be used for the manual WHMCS installation:

Version 6.3.1 - Full Package - Download
Release Date: 13th Apr 2016

Incremental patch V6.3.1 - Download
Release Date: 13th Apr 2016

The other versions can be downloaded at the article "How to upgrade WHMCS"

Installing Ioncube

Need to take into account that WHMCS is encrypted using loncube to protect the source code. If you use cPanel control panel, you already have loncube 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 in 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 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 installation is completed, we recommend that you go through and configure your new WHMCS system in the following order:

1. Log in to 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 (Setup > Products and Services ).
4. Configure your Domain Pricing (Set up > Domain Pricing ).
5. Set up your Support Ticket Departments (Setup > Support Departments ).
6. Setup 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 setup and configure automated tasks (Setup > Automation Settings).
8. Place some test orders on your website to check everything works as expected.

NOTE: Per our policy, refunds do not apply to WHMCS licenses (branded or non-branded ones) that are purchased at additional fee.


We welcome your comments, questions, corrections and additional info relating to this article. Your comments may take some time to appear. Please be aware that off-topic comments will be deleted.

If you need specific help with your account, feel free to contact our Support Team. Thank you.

Need help? We're always here for you.

× Close