Troubleshooting UpdatesMake sure to check for any problems both during and immediately after the upgrade process.
Updating WHMCSYou can check for updates and apply them directly in the Admin Area using the automatic updater.
Set Up a Test EnvironmentTo prevent problems, we recommend testing updates and customizations in a test environment before applying them to your production server.
Admin Directory ErrorsTroubleshoot and resolve You are attempting to access the admin area via a directory that is not configured. errors.
Fatal Error Fetching UpdateTroubleshoot and resolve A fatal error occurred while fetching the update errors.
ionCube Fatal Decoding ErrorsTroubleshoot and resolve Fatal error: The file was encoded by... errors.
Legacy Module RemovalWhen you update WHMCS, the system will attempt to delete unused legacy modules. This helps to prevent problems due to older PHP code.
Manually Update CustomizationsIf you use custom themes or templates, you will need to update them for any changes in new WHMCS versions.
New Version Not AppearingTroubleshoot and resolve new versions not appearing after checking for updates.
No Existing Installation ErrorsTroubleshoot and resolve No Existing Installation Was Detected errors.
Update Dry Run ErrorsTroubleshoot and resolve Apply update dry-run detected permission issues errors.
Check for UpdatesWHMCS automatically checks for new updates daily. You can also check for updates to WHMCS manually from within the Admin Area.
Prepare to Update WHMCSBefore you update your WHMCS installation, we recommend several preparatory steps.