Upgrading

From WHMCS Documentation

Revision as of 09:16, 21 May 2013 by Matt (talk | contribs) (Downloading the Latest Version)

We aim to make upgrading WHMCS as simple as possible. Below we hope to provide everything you might need in order to successfully and confidently update your WHMCS installation.

Upgrade Service

We offer a professional upgrade service where our staff will upgrade your WHMCS installation for you. Please refer to http://www.whmcs.com/services/upgrade-service/ for more information and to order that.

Manually Upgrading

If you choose to upgrade yourself, please follow the instructions below and in the release notes for the specific version to ensure a successful upgrade.

You can upgrade from any WHMCS version from 3.2 onwards to the latest. You do not need to do each incremental release between your current version & the latest in order to upgrade. Simply download the full release package for the latest version as described below and then follow the upgrade instructions linked to in the included README.txt file.

Downloading the Latest Version

  1. Begin by logging in to the client area @ http://www.whmcs.com/members/clientarea.php or obtain the latest version from your web host if you received your key from them
  2. Navigate to Services > Licenses & Services
  3. Select one of your active license keys and click View Details
  4. Now select the Downloads tab
  5. The latest stable release can then be downloaded using the large green "Download Now" button

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 either from our client area (Upgrading#Downloading_the_Latest_Version) or from the provider of your license
  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. These are listed in the Template Changes section of our Release Notes (see below).
  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.

Release Notes

Version NumberFirst Release DateRelease Notes
Version 8.1018th March 2024View Release Notes
Version 8.96th December 2023View Release Notes
Version 8.827th July 2023View Release Notes
Version 8.721st December 2022View Release Notes
Version 8.67th September 2022View Release Notes
Version 8.520th April 2022View Release Notes
Version 8.41st December 2021View Release Notes
Version 8.313th October 2021View Release Notes
Version 8.221st June 2021View Release Notes
Version 8.129th Dec 2020View Release Notes
Version 8.028th Sep 2020View Release Notes
Version 7.107th April 2020View Release Notes
Version 7.98th January 2020View Release Notes
Version 7.828th August 2019View Release Notes
Version 7.721st January 2019View Release Notes
Version 7.631st July 2018View Release Notes
Version 7.52nd April 2018View Release Notes
Version 7.414th November 2017View Release Notes
Version 7.33rd October 2017View Release Notes
Version 7.216th May 2017View Release Notes
Version 7.114th December 2016View Release Notes
Version 7.03rd October 2016View Release Notes
Version 6.329th March 2016View Release Notes
Version 6.29th December 2015View Release Notes
Version 6.122nd September 2015View Release Notes
Version 6.0 7th July 2015View Release Notes
Version 5.35th February 2014View Release Notes
Version 5.212th March 2013View Release Notes
Version 5.16th July 2012View Release Notes
Version 5.024th November 2011View Release Notes
Version 4.518th May 2011View Release Notes
Version 4.413th December 2010View Release Notes
Version 4.318th August 2010View Release Notes
Version 4.210th March 2010View Release Notes
Version 4.130th September 2009View Release Notes
Version 4.06th May 2009View Release Notes