How to Manually Install WHMCS

1. 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, VPS or dedicated server plan.

2. Download WHMCS

Once you've requested your license from WHMCS, you may download the program by logging into your WHMCS client area at www.whmcs.com/members and following these steps:

  1. Click on the My Licenses & Services link.
  2. Select one of your active license keys to view its details.
  3. Choose the latest stable version to download from the downloads listed at the bottom of the page.

3. Install WHMCS

The following instructions will guide you through manually installing WHMCS

Step 1: Create The Database

You will need to login to your cPanel and create a database and database user in MySQL Database.

Step 2: Manual Setup

  1. After downloading the WHMCS installation files, You will need to unzip them to be uploaded to the server.
  2. Once you have unzipped WHMCS it will then need to be uploaded. This can be done via FTP or through your cPanel File Manager interface.
  3. You will need to rename the file configuration.php.new to configuration.php
  4. Next, you can rename the folder whatever you like (billing, clients, etc.)

Step 3: Run the Installation Script

  1. Visit the installation script at http://www.example.com/whmcs/install/install.php to run the installation process (replace example.com with your actual domain name, and replace "whmcs" with the directory you placed WHMCS in).
  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.
  4. Click Continue if everything checks out.
  5. Enter your License Key you received from WHMCS and the database you previously created, then click Continue.
  6. 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 4: Finishing Up Installation

You can complete the installation process by performing the following:
  1. In the installation path, delete the install directory.
  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 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.