How to Install WHMCS: A Complete Beginner’s Guide 2024

Planning to install WHMCS to automate your web hosting business? Great choice!

With advanced tools from WHMCS, you can boost up the profit of your business. Looking for a complete guide to install WHMCS? If yes, then we can help you out.

Best Custom WHMCS Development Services

Have a look at the steps you need to follow to install WHMCS.

Let’s get started!

Step 1. Download WHMCS

If you want to directly download WHMCS then visit here.

Are you a reseller customer? If yes, then you must have obtained your license key from a reseller but no login for our member’s area. Isn’t it? Your reseller can provide the latest WHMCS files in this case.

Step 2. Install Ioncube

How to protect the WHMCS source code? ionCube Loader® is used to encrypt the WHMCS and protect the source code. Usually, hosting providers prefer to compile iobCube support into PHP.

Need help to install ionCube on your server? You can explore the internet for IonCube Installation Tutorial.

Step 3. Create Database

How to store settings and data? Well, WHMCS uses a MySQL® database. During the installation process, you can create one database or you can choose to create one before you begin.

You can check the Database Setup tutorial on the internet for more information. You may get different tutorials for creating databases in cPanel & WHM and Plesk.

Step 4. Restrict Database Privileges

Have a look at database privileges you will need for many tasks:
Additional privileges required for installation, up-gradation, and activating and deactivating modules including:
  • DROP

Step 5. Install WHMCS

Let’s have a look at the following process to install WHMCS:

    1. First, find the .zip file and unzip the content to a folder on your computer.
    2. Second, change the name of the file from to configuration.php.
    3. Third, the entire WHMCS folder needs to be uploaded to your website. Facing a problem with uploading the folder? Try uploading the folder in binary mode.
    4. Rename the folder such as billing. It is an optional step. However, you can’t name the installation folder as admin as it is used by the administration area.
    5. Then navigate the installation script and click on it to run the installation. and in case if you see an error related to ionCube then perform the ionCube steps mentioned above.
    6. Follow all the instructions like entering the license key, file permissions, and so on to install the WHMCS.

Once done with this delete the installation folder from the web server and keep a check on the configuration.

Step 6. Installing WHMCS in cPanel

  1. Do you use cPanel? Want to install WHMCS there? Just follow these steps and your task will be done.
  2. The first thing to do is to check whether the hosting provider has installed WHMCS using WHM software.
  3. Then log in to your cPanel account and there click on the site software icon.
  4. Then you will be able to see the option of WHMCS click on it.
  5. Choose the domain you want to install WHMCS in.
  6. Then click on the install option.
  7. This can take up to 30 seconds to install. After it finishes, you’ll see a message of success, a link to the login page, and the default login credentials automatically generated.
  8. Then click on the link which is provided when you log in for the first time.
  9. The interface will prompt you to check and agree to the End User License Agreement upon first logging in.
  10. In this step, you have activated WHMCS. If you already have one, enter an existing WHMCS license key to do this, or follow the link to purchase a new license.
  11. Once you are done with entering the license key Click Activate to validate and complete the process.

Your WHMCS is ready to use now!

Find Out How To Install A WHMCS Theme Or A Template?

Post Installation Suggested Steps

Configure WHMCS in the following order

  1. The very first thing to do is to perform further security steps.
  2. Log in to your account and then configure its setting. (Configuration > System Settings > General Settings or, prior to WHMCS 8.0, Setup >General Settings).
  3. In this step all you have to do is to set up the payment gateways, (Configuration > System Settings > Payment Gateways or, before WHMCS 8.0, Setup >Payment Gateways).
  4. Then set up the products and services you are offering (Configuration > System Settings > Products/Services or, before WHMCS 8.0, Setup >Products and Services).
  5. In this all you have to do is to configure your domain pricing (Configuration > System Settings > Domain Pricing or, before WHMCS 8.0, Setup > Domain Pricing).
  6. Then set up the support ticket departments (Configuration > System Settings > Support Departments or, before WHMCS 8.0, Setup Support department).
  7. Using WHMCS Support Desk to set up email piping so you can handle tickets. For more detail see Piping by Email.
  8. Make sure the WHMCS cron job is activated and configure automated tasks (Configuration > System Settings > Automation Settings or, prior to WHMCS 8.0, Setup >Automation settings).
  9. Then for a trial place some test orders and check whether the setup is working or not.

Now, you are ready to install WHMCS in a few steps.

Looking for Something More? We can help!

Our WHMCS experts are ready to accept your custom requirements.