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.

We recommend:

  • installing WHMCS in it's own cPanel account.
  • selecting the latest PHP version supported, and increasing PHP memory_limit to 512Mb and max_execution_time to 300.
  • ensuring you have added a LetsEncrypt SSL certificate to the domain you're going to install WHMCS on.

WHMCS requirements:

  • ensure Ioncube_loader, soap and xmlrpc are enabled.
  • ensure escapeshellcmd (and escapeshellarg if you want to use the WHMCS Update Utility) is removed from the disabled functions list.
  • create a MySQL database and user for WHMCS.
    Required permissions for the MySQL user are DELETE, INSERT, SELECT, UPDATE, LOCK TABLES and additionally during installation, upgrade, activating & deactivating modules ALTER, CREATE, DROP & INDEX.

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 website 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.

We also have a guide on using Installatron to install WHMCS - which achieves a similar result, but will create the database for you during the installation.

WHMCS Documentation - Installing WHMCS

  1. Login to your Krystal Client Area
  2. Click Hosting from the menu bar or under Your services.
  3. Identify your reseller package and click the Manage button
  4. Click WHMCS License in the left hand menu
  5. Click the Download Vx.x.x button
  6. Find the downloaded WHMCS_vxxx_full.zip file on your system and extract the zip file using your preferred zip tool.
  7. 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 other folder) using cPanel File Manager and then un-zip it once it's uploaded (then delete the zip file you uploaded).
  8. 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 other folder).
  9. Find the file name configuration.php.new and rename is to configuration.php
  10. 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.
  11. 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.
  12. 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 create.
    Click Continue.
  13. You'll now be prompted to setup the Admin user.
    Enter all the details required and click Complete Setup to continue.
  14. 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.
  15. 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.
  16. The remaining two steps each have separate guide - you should complete them in order.
  17. Securing/Hardening your WHMCS Installation (second instruction - Secure the writeable directories)
  18. Setting up the WHMCS CRON job (third instruction - Setup the Daily CRON job)
  19. 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
© Krystal Hosting Ltd 2003–2019