Installing WHMCS manually

This guide walks you through downloading the latest version of WHMCS from within the Krystal Client Area and installing it.

Prior to installing WHMCS it's important to ensure you have met the WHMCS System Requirements - external link opens in a new window.

We recommend:

WHMCS requirements:

We have a separate guide on changing PHP versions, enabling extensions and changing options.

For the purposes of this guide, WHMCS will ultimately be accessible directly on your apex domain URL e.g. https://example.co.uk. Should you wish to install WHMCS within a folder e.g. https://example.co.uk/whmcs you can do so - just create and upload the WHMCS files to the folder you'd like to use in Step 7 - and be sure to adjust any URLs in other guides to include your folder if necessary.
Likewise, WHMCS can also be installed in a sub-domain if you create that first.

WHMCS Documentation - Installing WHMCS (external link opens in a new window)

  1. Login to your Krystal Client Area
  2. Within your Krystal client area - click on the My Services icon or click Services > My Services on the menu to view your current plans.
  3. Identify your reseller package and click the Manage button
  4. Towards the bottom of the page, you'll find the WHMCS License section. Click the Download Vx.x.x button.
    It's also worth taking note of your License key at this point as you'll need it in Step 11.
  5. Find the downloaded WHMCS_vxxx_full.zip file on your system and extract the zip file using your preferred zip tool.
  6. Within the extracted folder you'll see a whmcs directory - upload the contents of this directory to the /public_html directory (or folder) where you want to setup WHMCS using an FTP client. Alternatively, you could select all the files/directories inside the whmcs folder and zip them up, upload that .zip file to your /public_html directory (or another folder) using cPanel File Manager and then un-zip it once it's uploaded (then delete the zip file you uploaded).
  7. Your server view within cPanel File Manager or your FTP client once you've uploaded WHMCS should look something like this - with the admin and other files/directories directly inside your /public_html directory (or another folder).
  8. Working on the server - find the file name configuration.php.new and rename it to configuration.php
  9. Once you've uploaded the files you should visit https://your-domain.co.uk/install - replacing your-domain.co.uk with your actual domain.
    Click the I Agree button to accept the license agreement.
  10. WHMCS will perform some System Requirements checks and if all pre-requisite steps have been completed successfully it should pass.
    Click Begin Installation to continue.
  11. You'll now need your WHMCS license key, and the details of the database and database user you created in the pre-requisites.
    Enter the WHMCS license key, Database Username, Database Password and Database Name for the MySQL database and user you created.
    Click Continue.
  12. You'll now be prompted to set up the WHMCS Admin user.
    Enter all the details required and click Complete Setup to continue.
  13. Once the installation completes you'll see the final screen detailing some further actions that need to be completed before you can start using WHMCS.
  14. The first instruction is to delete the /install/ folder - you won't be able to access WHMCS until you do this. You can complete this using either cPanel File Manager or your FTP client.
  15. The following two steps each have a separate guide - you should complete them in order.
  16. Securing/Hardening your WHMCS Installation
  17. Setting up the WHMCS CRON job
  18. Once you've completed those guides you can click Go to the Admin Area Now you'll be presented with the WHMCS post-installation wizard.


How did we do?


Powered by HelpDocs (opens in a new tab)
© Krystal Hosting Ltd 2002–