Installing

Video Guide

Watch our installation video guide, or scroll down to read the illustrated guide below. 

Downloading

First, download WHMCS so that you can upload it to your server. To do this, visit https://download.whmcs.com/.

To download the Full Release of WHMCS, click Download for your desired version. We always recommend the latest version of WHMCS, which is highlighted at the top of the list.

Uploading WHMCS to Your Server

Next, install the software to your web server. This example uses a cPanel server, and you can use our installation documentation for guidance if you use a different type of server.

First, log in to the cPanel account and upload the .zip file. To do this, use cPanel's File Manager interface.

Navigate to the public_html directory by double-clicking on the folder icon.

Click Upload, and then, on the next screen, choose Select File. Browse to the zip file, choose it, and then wait for it to upload.

After the .zip file is uploaded, click Go Back to "/home/username/public_html". The File Upload screen will close and you will see the newly-uploaded .zip file in the public_html directory.

Next, right-click the .zip file and choose Extract. The system will prompt you for a destination. Choose a destination, and then click Extract File(s). In this example, we're extracting it to the public_html folder.

After the files finish extracting, one of the newly-extracted files is configuration.php.new. Rename this file to configuration.php.

Creating the Database

While still in cPanel, create the MySQL® database to use for the WHMCS installation. First, go to the MySQL Database Wizard interface. This interface will guide you through the process of creating the WHMCS database.

Use the interface to choose a database name, username, and password, and to set permissions. Make sure to note the database name, username, and password selected.

When you reach the Privileges section, choose All Privileges.

Make sure to note the database details, since you will need them later in the process. 

For databases, cPanel uses the cPanel account username, an underscore, and then the database name or username.

Next, launch a new browser window and go through the WHMCS Installation Wizard.

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

The WHMCS Installation Wizard will appear..

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

The installer script will guide you through the rest of the process, requesting the license key, which you can find in the Client Area or in your Welcome Email.

Enter your database information in the corresponding fields.

Enter the details for your first full administrator user and click Complete Setup.

Make sure to copy and save the daily cron job command (in grey). It's unique to your server and you will need it later in the process.

When you see the Installation Completion page, remove the /install directory from your server.

You can do this by right-clicking the /install folder in cPanel's File Manager interface 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!