Revision as of 15:58, 4 June 2012

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/upgradeservice.php 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 new release will be displayed last on the list of downloads, along with the data of release for verification

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 downloading the latest version of WHMCS, either from our client area (Upgrading#Downloading_the_Latest_Version) or from the provider of your license
2. Next, unzip the contents of the latest WHMCS zip file download to a folder on your computer
3. Now remove the /images/logo.jpg file to avoid overwriting your customised logo image
4. Next 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 overwriting any existing files
6. Visit the admin area as you normally would to login and you should then see the upgrade script. If this is not shown automatically, please manually visit /install/install.php to run the upgrade process.
7. Accept the license agreement
8. Now take a full backup of your database using a tool such as phpMyAdmin
9. Tick to confirm you have backed up your database and click the upgrade button
10. If you are prompted for any database information *STOP* and check your configuration.php file is still in place and then start the upgrade process again
11. Once the updates finish, delete the install folder from your server
12. 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).
13. 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