How To Install WHMCS Manually As A White Label Reseller

The first step to getting started with White Label Reseller Hosting, is to install and configure WHMCS. This can be done rather quickly, and can also be done by our support technicians for you once you order this service from Hostwinds. This guide is intended for clients who wish to install this themselves.

 

Download WHMCS Installation Files

While logged into your client area within Hostwinds, navigate to Support -> Downloads

 

Hostwinds Download Location Image

 

Next, click on the link for Purchased Software Downloads, and select the latest version of WHMCS available. At time of this article, it would be WHMCS v7.4.2. Click the Download link, and the archived folder will be downloaded to your machine locally.

 

Hostwinds Download WHMCS Option Image

 

Upload WHMCS Installation Files to your Account

Next, login to your FTP account through an FTP client of your choosing, your default logins to access your FTP will be in the following format:

 

Hostname: either your domain name, or your server’s hostname

Username: Your cPanel / FTP username

Password: Your cPanel / FTP password

Port: 21

 

Login information provided in a welcome email upon purchasing.  We also recommend using FileZilla as your FTP client

 

Once you are logged into using your FTP client, navigate to the folder public_html. Please keep in mind that anything within this folder is live, and online and is the document root for your main domain name.

 

Next, navigate to the folder in which you wish to have WHMCS installed. If you would like to have WHMCS installed on your main domain, simply staying within the public_html folder will create yourdomain.com/whmcs. If you would like to have WHMCS be on a subdomain, you can create a subdomain within cPanel and then unzip the files there to your subdomain document root. This means you can have WHMCS installed to clients.yourdomain.com/whmcs or any variation of subdomain / folder schema you choose.

 

On your local machine, unzip the folder into a directory of your choosing, using either WinZip, WinRar, 7zip, or any other version of archiving software you wish to use.

 

From there, you will drag the entirety of the unpackaged folder structure to your location of your choosing.

 

WHMCS Extract Example Image

 

If you do not have software on your local machine to unzip/unpack archived folders, you can directly upload the .zip download to your account using File Manager. Once the file is uploaded to your account using File Manager, you can right click on the .zip archive, and extract using cPanel’s File Manager extraction.

 

Pre-Install: File Changes and Updates

At this time, you can navigate to your URL that you have unzipped the WHMCS folder to, so this would be wherever you unzipped the above package, and navigate to this URL in your browser, ie: http://mydomain.com/whmcs

 

You will be greeted with the following page, click on the Click here to begin link.

 

Welcome To WHMCS Image

 

Next, WHMCS’s End User License Agreement will be displayed, review the license agreement, and once accepted click on “I Agree“.

 

WHMCS Failed To Load Example Image

 

The next page will indicate that a file is missing, this is perfectly normal.  To correct this, navigate to the WHMCS folder in your FTP account or cPanel file manager, and locate the file named: configuration.php.new rename this file to configuration.php

 

rename configuration file example image

 

Once this file has been renamed, click on the button for Recheck Requirements. You should be met with the following screen:

 

WHMCS Begin Install Image

 

Installation of WHMCS

Now that you have seen the above screen, click on Begin Installation

 

WHMCS License Key Example Image

 

The screen will request information on your WHMCS license key, and your database connection details.

 

WHMCS License Key

This can be obtained from your Hostwinds’ client account at https://clients.hostwinds.com. Navigate to Services -> My Services, and search/locate your White Label Reseller service, and click Manage.

 

WHMCS MyProduct Manage Location Image

 

Your WHMCS license key is an addon to this service, so on the left navigation panel from the White Label Reseller Account service management page, click on Addons.

 

Manage Addons of WHMCS Location Image

 

At the very bottom of the Addons page, you will see “Current Addons” and a WHMCS White Label License Key, your key is displayed there. Copy from WHMCS- to the end of the line.

 

WHMCS License Key Image

 

Next, paste the copied key on your WHMCS installation page, in the License Key field.

 

Database Connection Details

You will need to create a database, and a database user, this is fairly simple to complete using cPanel’s MySQL Databases feature.

 

cPanel MySQL Location Image

 

Login to your cPanel account, and navigate to MYSQL Databases. You can easily find this by searching in the search field the word sql.

 

Both your MySQL username and MySQL database name will be prefixed with your cPanel username. Simply name them both with whatever you wish and it is entirely up to you. THese can be as simple as username_whmcs for both, or very complex, it’s entirely up to you.

 

Create New Database In cPanel Example Image

 

Under Create New Database, name the database you are creating. In this example we will be naming it cpanelusername_whmcs. Once the database is named, click Create Database.

 

Next, create a database user under Add New User. Here, you can create the username you wish to use, as well as a secure password. Ensure you store this password safely, as you will be using it to complete the installation. In this example below, the username follows the same schema as the database name, being ucpanelusername_whmcs. Once both the username and password has been filled in, click on Create User.

 

cPanel MySQL User Password Example Image

 

Lastly, you will need to give permissions for the user you have created on the database you have created. Scroll down to Add User to Database and ensure the user you have created is selected under the User dropdown, and that the Database you have created is selected under the database dropdown. Then, just click Add to add your user you created to the database you created.

 

Add User To Database Example Image

 

On the next page, you will select the checkbox All Privileges. This will allow the database user full control of the database. Once All Privileges are granted to the user, press the Make Changes button at the bottom of the page.

 

Manage User Privileges Example Image

 

Now, you can update the fields on the WHMCS installation page!

 

  • Database Host: Keep as default, being localhost
  • Database Port: Keep as default, being 3306
  • Database Username: This will be the user you created. Ensure it includes your cpanelusername prior to the underscore.
  • Database Password: This will be the password you set for the database user
  • Database Name: This will be the database you created. Ensure it includes the cpanelusername prior to the underscore.

 

Once all of the fields have been filled in, click Continue.

 

Setup Administrator Account

Setup Administrator Account Example Image

 

This will be the administrator account for your WHMCS installation. Fill in the details with your information such as email, desired username, desired password. Once this is entered press Complete Setup once ready.

 

The page will now begin the installation of WHMCS. Do not back out or close the page from this point. Once completed, you will be presented with a confirmation message seen below.

 

Installation Complete Successfully Image

 

Cleanup and Final Steps

You will need to delete the entire folder of /install/ from your WHMCS directory, this can be done either in your FTP client, or through cPanel’s File Manager tool.

 

Delete Installation File Example Image

 

Create Daily Cron Job

There will be an option to setup the daily cron job on this page, followed by a php command to use. Copy the command under step 3, that begins with php -q

 

Next, in your cPanel account, search for cron and select the option Cron Jobs

 

cPanel Cron Job Location Image

 

Under Add New Cron Job, there is a dropdown for Common Settings, select the option Once Per Five Minutes

 

Next, in the field below for Command, paste the copied php command, and press Add New Cron Job.

 

Add new Cron Job Image

 

Now, you can click on the button to go to the admin area on the installation page of your WHMCS. You may login with the login details you created for the setting up of an admin user account.

 

Congratulations, WHMCS is now fully installed and setup on your hosting account!.


Share:

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.