How to Install WHMCS

Obtain a WHMCS License

To install WHMCS, you must first obtain a WHMCS License. HostGator Reseller and Linux Dedicated Server plans include a FREE WHMCS license which can be obtained here.

Note: Your domain name must resolve to your hosting account before it will let you request your license.  Usually this means changing the name servers for your domain to our name servers at the registrar.

VPS customers can obtain a WHMCS license from HostGator for $5 per month. The license can be requested here.

Note: The WHMCS license offered from HostGator is only valid if WHMCS is installed on your HostGator reseller account, VPS or Linux Dedicated Server. You may also purchase a license directly from WHMCS if you do not have a reseller plan, VPS or dedicated server.

Install WHMCS

The instructions below will guide you through installing WHMCS via Quickinstall.

Step 1: Quickinstall Setup

  1. Log in to cPanel.
  2. Under Software/Services, click Quickinstall.
  3. In the left-menu, under Billing Software, click WHMCS.
  4. Click Continue.
  5. Select the path where you would like the software installed.
  6. Enter the administrator email address so the database details can be generated and emailed to you.
  7. Click Install Now!

Step 2: Run the Installation Script

  1. Visit the installation script at http://www.yourdomain.com/whmcs/install/install.php to run the installation process. (Replace yourdomain.com with your actual domain name and be sure to replace "whmcs" with the directory you selected.)
  2. After reading the WHMCS End User License Agreement, click I Agree to continue.
  3. The initial setup will perform some checks to ensure you meet the system requirements and permission requirements. Click Continue.
  4. Enter your License Key and the database details provided with your Quickinstall setup then click Continue.
  5. Enter the details in the form for the administrator account so that you can access and setup your WHMCS installation, then click Complete Setup.

Step 3: Finishing Up Installation

You can complete the installation process by preforming the following:
  1. In the installation path delete the install directory. For example: http://www.yourdomain.com/whmcs.php
  2. (Optional) For additional security, you can move the attachments, downloads, and templates_c directories outside of any publicly accessible directories.
    • You can follow the walkthrough provided by WHMCS to move the directories.
  3. Setup your Cron to ensure WHMCS is performing its required scheduled tasks once a day.
    • This can be done through cPanel's cron job feature or through command line using the example below. (Be sure to replace username with your actual cPanel username.)
0 0 * * * php -q /home/username/public_html/whmcstest/admin/cron.php

Congratulations! WHMCS is now set up.


WHMCS WHMCS allows you to manage your online business, and includes client management, billing & support functionality.

A WHMCS license is included FREE with HostGator Reseller Packages and Linux Dedicated Servers.