To avoid problems when updating WHMCS, you will need to take some preparatory steps to ensure that your system is ready.

Prepare to Update #

Before you update WHMCS, we recommend following the process below:

1. Check the release notes. #

Always start by checking the release notes for your new WHMCS version. They contain important information about new features, changes, deprecations or removals, and template changes.

If you are upgrading through multiple versions, check the release notes for each intermediate version. For example, if you are upgrading from WHMCS 8.8 to WHMCS 8.10, check the release notes for WHMCS 8.9 too.

2. Check the system requirements. #

Before updating, you must ensure that your setup meets the system requirements for your chosen version of WHMCS and any intermediate versions that you will upgrade through.

3. Check your customizations. #

If you use custom system themes or order form templates, make certain that these exist within their own directories. Updates will often overwrite changes that you make to the default themes or templates.

You can find information about template changes and links to view those changes in our GitHub® template repositories in the desired version’s release notes.

We recommend using Git™ to update most customizations, including custom themes and order form templates. However, we recommend using override files to make the following customizations:

• Language text and phrasing updates
• WHOIS server additions and changes
• Country and calling code modifications

4. Test updates before production. #

WHMCS performs comprehensive automated and manual testing of each new release, but differences in environments, system configuration, and customization can cause unanticipated issues for individual installations.

Because of this, we recommend creating a test installation to check for potential update issues before you apply updates to your production system. The test system should be an exact replica of your production installation.

5. Back up your installation. #

Before you update, create backups of the WHMCS database and the entire WHMCS directory. If you experience problems while updating, doing this will allow you to quickly revert your changes.

6. Check MySQL® permissions. #

The update process will need to create and alter tables in the MySQL database. Make sure that the MySQL user has all available permissions for the duration of the update process.

Performing the Update #

When you are ready to perform the update, you can choose between several update methods:

Last modified: June 14, 2024