WHMCS is a complete automated billing solution for your web hosting business. You can use this application to create and renew orders, invoices, etc. for your customers easily. In short, it’ll take care of all the financial aspects of your hosting business.

Well, you might find its setup tedious, but using this article it will be super easy for you. And trust us when we say, its all just worth the effort for WHMCS. :)

So let’s starts:

Step 1: Getting your WHMCS License Key

To start off, you’ll need to keep your WHMCS license key handy.

If you’ve got a Linux Reseller Hosting with us, we give you a WHMCS License Key absolutely free along with your purchase. To find your License Key, here’s what you need to do:

1. Login to your account

2. You will now see a page that lists all purchases made by you on our system

3. Click on the domain name associated with your Reseller Linux Hosting

4. This will take you to a page where you see your hosting package details

5. Click on "WHMCS"

6. Click on "Request Key"

That’s it. You’ll see your WHMCS License Key right in front of you. Keep a note of this License Key.

If you’ve got a VPS Hosting, you’ll need to purchase a WHMCS license if you’ve not purchased one yet.

1. Login to your account

2. You will now see a page that lists all purchases made by you on our system

3. Click on the domain name associated with your VPS Hosting

4. This will take you to a page where you see your hosting package details

5. Click on "Manage Add-ons"

6. Select "WHMCS" from the drop down

7. Click on "Add"

8. Go ahead and make the payment to get your fresh license of WHMCS

You’ll be able to see the WHMCS license key by clicking on "Admin Details" below your VPS Hosting package order details. Keep a note of this License Key.

Step 2: Installing Ioncube Loader

If you’ve got a Reseller Linux Hosting, we’ve got this pre-installed for you already, however, you’ll just need to make a few modifications to get it fully there. Here’s what you need to do:

1. Login to your web hosting packages web root directory (public_html) using cPanel or FTP

2. Edit the php.ini file. If you don’t see one, just create a file using this name

3. Add the following code to this file

If you’ve got PHP 5.4: zend_extension=/usr/local/altphp54/lib/php/extensions/no-debug-non-zts-20100525/ioncube_loader_lin_5.4.so

If you’ve got PHP 5.3: zend_extension=/usr/local/altphp/lib/php/extensions/no-debug-non-zts-20090626/ioncube_loader_lin_5.3.so

Step 3: Downloading WHMCS

Now that you have the license key, you’ll need to download the latest stable copy of WHMCS from their official website.

1. Just visit http://download.whmcs.com/

2. Click on "Download" under the Full Release heading - this will be the latest release version

Step 4: Installing WHMCS

1. Unzip the contents of the zip file that you’ve just downloaded to a folder on your computer

2. Rename the file configuration.php.new to configuration.php

3. Upload the entire whmcs folder to your website

4. Next you can rename the folder as per your preference (whmcs, billing, clients, etc). This would be used in the URL whenever you’d like to access your WHMCS. For example - http://www.yourdomain.com/whmcs or http://www.yourdomain.com/billing, etc

5. Now visit the installation script using the directory /install/install.
   For example, if you’ve named the directory as whmcs, the URL would be: http://www.yourdomain.com/whmcs/install/install.php

6. This will run the installer process like an easy wizard. 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 & folders permissions

/configuration.php CHMOD 400  - Readable

/attachments CHMOD 777 - Writeable

/downloads CHMOD 777 - Writeable

/templates_c CHMOD 777 - Writeable

The above applies unless your php is suPHP or PHPSuExec. If using DSO as your php handler, you must use 644 permissions.

Step 4: Post-Installation Steps

After your installation is completed, we’d recommend that you go review the available customizations and configure your new WHMCS system per your needs

1. Perform the recommended Further Security Steps

2. Login to the Admin Area and configure your General Settings (Setup > General Settings)

3. Setup your Payment Gateways (Setup > Payment Gateways)

4. Setup your Products & Services (Setup > Products and Services)

5. Configure your Domain Pricing (Setup > Domain Pricing)

6. Setup your Support Ticket Departments (Setup > Support Departments)

7. Setup email piping so you can manage tickets using the WHMCS Support Desk - for full instructions on this please see the Email Piping article

8. Ensure the WHMCS Cron Job is setup and configure automated tasks (Setup > Automation Settings)

9. Place some test orders on your website to check everything works as expected

That’s all folks! Now that you have your WHMCS setup ready, you can grow your business to the next level using this awesome billing automation tool.