How to install WHMCS?

WHMCS is a popular billing, support, and an automation system for web hosting service providers. This tutorial plus the video tutorial will cover all the steps (with images of each step) you would need to follow to install WHMCS successfully. The installation process is actually quite simple and easy if your server meet all the system requirements.

Generally, any server running a control panel such as cPanel or Plesk will meet the requirements. If non are met, you should be notified of this during the install process. For the purpose of  this tutorial, I’d assume you’ve already purchased a license for WHMCS.

  1. Download latest version of WHMCS from WHMCS client area and extract it on your computer.
  2. Double click on WHMCS folder.open-the-downloaded-whmcs-folder
  3. Remove .new from the configuration file’s name.rename-the-configuration-file-and-remove-new
  4. With the file renamed, upload the entire WHMCS folder to your FTP server. (Go to public_html >whmcs-install-folder >templates (note: whmcs-install-folder is the folder that you have installed WHMCS. Example: public_html/billing/templates, wherebilling is whmcs install folder) and upload the folder)
  5. Because the WHMCS code is encrypted, the Ioncube loaders are required for it to function. Your server may already have these installed. If it does not, you’ll be unable to proceed any further. There should be an Ioncube folder in the archive you extracted. Simply upload that folder inside the WHMCS directory you just uploaded. If the Ioncube folder is not present, contact WHMCS support for the files, or contact our support department to have Ioncube set up for your entire server.
  6. After all the files have been uploaded, you’re ready to begin installation. Go to the installation script here: http://www.yourdomain.com/whmcs/install/install.phpaccept-end-user-license-agreement
  7. Read through the license agreement, then scroll down. Click I agree.click-on-i-agree-button
  8. If any of the permissions checks fail, you will need to adjust the CHMOD permissions as described for each file. This can be done using your FTP client or control panel.pass-system-requirement-check
  9. Once all checks have been passed, click Continue.click-on-continue-button
  10. Type here your license key.type-in-WHMCS-license-key
  11. Fill out the database information.type-in-database-connection-details
  12. Click Continue.click-on-continue-button-to-proceed
  13. Enter account details for your primary administrator account. enter-details-to-setup-adminstrator-account
  14. Click Complete Setup »click-on-complete-setup-button
  15. Installation is now complete! You should delete or at least rename the install directory before proceeding.installation-complete-screen
  16. Also, be sure to change the CHMOD permissions for configuration.php back to 644 if you needed to change them earlier.
  17. Then, go to yourdomain.com/whmcs/admin/ to see if the log in page appears.click-on-the-link-to-return-admin-area
  18. Here it is! You can now log in to WHMCS.whmcs-login-interface

There are a few post-installation stpes that should be taken before actively using WHMCS. For details, watch the two tutorials that follow.

How to install WHMCS?