How to upgrade WHMCS

If your WHMCS billing platform was installed using Softaculous script installer, it should be upgraded with it as well. If your WHMCS was installed manually, you need to upgrade it manually.

These are the files that can be used for the manual upgrades:

This is recommended version for all new installs and upgrades from any earlier version:

Version 5.3.6 - Full package - Download
Release Date: 25th Mar 2014

Version 5.3.5 -
Full package - Download
Release Date: 20th Feb 2014

Version 5.3.3 - Full package - Download
Release date: 5th Feb 2014

V5.2.15 - Full packageDownload
Release date: 23rd Dec 2013

V5.1.13 - Incremental Patch Update - Download
Release Type: SECURITY - 25th Oct 2013

V5.2.9 - Incremental Update - Download
Release Type: Full Package - 18th Oct 2013

V5.2.8 - Full Package - Download
Release Type: STABLE - 3rd Oct 2013

V5.2.7 - Full Package - Download
Release Type: STABLE - 26th Jul 2013

V5.2.6 - Full Package - Download
Release Type: SECURITY - 23rd Jul 2013

V5.2.5 - Full Package - Download
Release Type: SECURITY - 16th May 2013

V5.2.4 - Full Package - Download
Release Type: MAINTENANCE - 23rd Apr 2013

V5.2.4 - Incremental Patch Update - Download
Release Type: MAINTENANCE - 23rd Apr 2013 Compatable with WHMCS V5.2.3 Only

V5.1.6 - Full Package - Download
Release Type: STABLE - 23rd Apr 2013

Performing an Upgrade

The steps needed to upgrade WHMCS can vary from version to version and so full steps, including any template changes required for each version are included in the Release Notes below. However, the general process for upgrading always remains the same:

   1. Begin by taking a full backup of your WHMCS system - both files and database using a tool such as phpMyAdmin
   2. Now download the latest WHMCS version here
   3. Next, unzip the contents of the WHMCS zip file download to a folder on your computer
   4. Now if you have customised your WHMCS admin folder name, you should rename the admin folder in the new files to match
   5. Upload the new files to your existing installation folder replacing any existing folders & files
   6. Visit the admin area as you normally would to login and you should then be automatically redirected to the upgrade script. If this is not shown automatically, please manually visit /install/install.php to invoke the upgrade process
   7. Accept the license agreement
   8. If you are prompted for any database information *STOP*, this indicates the configuration.php file is missing and so a new install is being attempted - you need to restore the configuration.php before continuing
   9. Tick to confirm you have backed up your database and click the upgrade button to complete
   10. Once the updates finish, delete the install folder from your server
   11. Now proceed to update your custom templates with any new or changed files in the version you've upgraded to
   12. Finally clear your browser cache or perform a hard refresh (Ctrl + F5) and delete the contents of the template cache directory (usually called templates_c) to ensure you see the new templates



Support requests, bug reports, and off-topic comments will be deleted without warning.

Please do post corrections or additional information/ pointers for this article below. We aim to quickly move corrections into the documentation. Also, your comments may take some time to appear.

If you need specific help with your account, please contact Support

Left side occasional ads will now show here with an option to close and don't show again.

Need help? We're always here for you.

× Close