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
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.
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
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.
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.
Next, WHMCS’s End User License Agreement will be displayed, review the license agreement, and once accepted click on “I Agree“.
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
Once this file has been renamed, click on the button for Recheck Requirements. You should be met with the following screen:
Installation of WHMCS
Now that you have seen the above screen, click on Begin Installation
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.
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.
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.
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.
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.
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.
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.
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.
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
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.
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.
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
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.
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!.