Installing

Video Guide

We have produced a video guide covering installation of WHMCS.

Scroll down to read the illustrated guide below.

Downloading

The first step is to download the product to your computer so it can be uploaded to your server.

Visit https://download.whmcs.com/

On this page, you will be able to download the Full Release of WHMCS, which is needed to get started. Simply choose the Download  button for your desired version. We always recommend the latest version  of WHMCS, and it is highlighted at the very top of the page.

Uploading WHMCS to Your Server

Now that WHMCS is downloaded, the next step is to install the software to your web server. We will be utilizing a cPanel host for this example. If you do not have a cPanel server review our installation documentation here for guidance.

The first step is to login to the cPanel account and upload the zip file downloaded in the previous step. To do this, launch the File Manager in cPanel.

When File Manager opens, navigate to the public_html directory by double-clicking on the folder icon. You will then be taken to the public_html folder where you can upload WHMCS.

Choose the Upload option in the File Manager screen. On the next screen choose Select File and browse to the folder where the zip file was downloaded to. Choose the zip file and wait for it to upload.

Once the zip file is uploaded, choose the Go Back to "/home/username/public_html" button. The File Upload Window will close and you will see the freshly uploaded zip file in the public_html directory!

Next, right-click the zip file and choose Extract. A small window will pop up asking for the destination. In this example, we wish to extract it to the public_html folder, so we will click Extract File(s).

The WHMCS files are now extracted.

Amongst the newly extracted files is configuration.php.new

Rename this file to configuration.php

We are ready to begin the next step of the installation process - creating the MySQL Database.

Creating the Database

While we are still logged into cPanel, we must now create the MySQL database to be used for the WHMCS installation. First, choose the MySQL Database Wizard. This wizard will guide you through creating the database in which WHMCS will store data.

The wizard will walk you through choosing a database name, username, password, and set permissions. Utilize this wizard, taking note of the database name, username and password selected.

Once you get to the Privileges screen, simply choose All Privileges.

Make a note of the database details as we will need them in a moment

(cPanel utilizes the cPanel username followed by an underscore, then the database name/username)

Once the MySQL wizard has been completed, the next step is to launch a new browser window and run through the WHMCS Install Wizard.

In your browser, navigate to www.yourdomain.com/whmcs/install/, replacing yourdomain.com with your website address.

The WHMCS Installation Wizard is displayed.

Read and Agree to the End User License Agreement to continue.

The installer script will guide you through the rest of the process, requesting the license key (found in the Client Area or in your Welcome Email).

Enter the database details you noted down earlier into the corresponding fields in the installation wizard.

After finishing with this step, enter the details for your first full administrator user and click on Complete Setup.

Take a copy of the daily cron job command highlighted in grey. It's unique to your server and we'll need it in the next article

Once the Installation Completion page is shown, remove the /install directory from your server.

This can be done by right clicking the install folder in cPanel's File Manager and choosing Delete:

WHMCS is now installed! Continue reading to complete the important first setup steps:

Encountered a Problem?

Head over to our Troubleshooting Installation Issues section!