Installing & Configuring WHMCS


Once you have received your licence key installing WHMCS is very simple. 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. Create a MySQL Database via cPanel, instructions for doing this can be found here.
  6. Now visit the installation script at to run the installer process - if you get an Ioncube related error message, click here.
  7. 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
    • /configuration.php CHMOD 777 Writeable
    • /attachments CHMOD 777 Writeable
    • /downloads CHMOD 777 Writeable
    • /templates_c CHMOD 777 Writeable
  8. When complete, delete the install folder from your web server and CHMOD the configuration.php file back to 644.

Now that WHMCS is installed there are some further security steps that you can take to ensure the maximum level of security.


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

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

For further guidance, you can watch video tutorials WHMCS have prepared for the above tasks at

  • 0 Users Found This Useful
Was this answer helpful?

Related Articles

Who do I contact for support?

Your WHMCS licence is fully supported by WHMCS Ltd. you can contact them directly for the...

How to I download the software?

To download the WHMCS software: Click "My Sites" above, Click "View Details" next to your WHMCS...

License Invalid Error

If you see a "License Invalid" error message when attempting to login to your WHMCS admin area...

Can I move my installation?

Absolutely. However as your licence is tied to a specific IP address, folder and domain you will...

Download from WHMCS Documentation

If you wish to download any files from the WHMCS documentation please create a ticket to our...

Powered by WHMCompleteSolution