Revision as of 10:48, 2 August 2013

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. If you have customized any language files please create a new folder within the /lang folder naming it 'overrides'. Move your existing language files here
3. If you have customized the standard template files please ensure that you have renamed the folder to avoid your customizations being overwritten
4. Now download the latest WHMCS version either from our client area (Upgrading#Downloading_the_Latest_Version) or from the provider of your license
5. Next, unzip the contents of the WHMCS zip file download to a folder on your computer
6. Now if you have customised your WHMCS admin folder name, you should rename the admin folder in the new files to match
7. Upload the new files to your existing installation folder replacing any existing folders & files
8. 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.
9. Accept the license agreement
10. 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
11. Tick to confirm you have backed up your database and click the upgrade button to complete
12. Once the updates finish, delete the install folder from your server
13. 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).
14. 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