Guides & TutorialsUpdating WHMCS TroubleshootingTroubleshooting a Check for Updates Failed Error

Troubleshooting a Check for Updates Failed Error

You may encounter a Check for Updates Failed error in Configuration > System Logs (Utilities > Logs > Activity Log prior to WHMCS 8.0) during the daily automation tasks.

The message will be accompanied by further details. The resolution to common errors are detailed below:

 

Unable to connect to the WHMCS Update Server
Check for Updates Failed: Unable to connect to the WHMCS Update Server. Please try again later or contact support.

Set a Temporary Update Path

Begin by navigating to Utilities > Update WHMCS.

Utilities > Update WHMCS

The following warning will appear:

Warning You do not currently have a path configured for temporary storage of files during updates. You will not be able to perform an update until one is set.

Click Configure Update Settings in the top-right corner.

Configure Update Settings

In the box that appears, use Temporary Path to specify a writeable directory that WHMCS can use for temporary auto-update files:

If a suitable directory does not exist already, you will need to create one.

Next, click Save Changes.The warning message will disappear, indicating that the problem is resolved.

For more information and further troubleshooting steps, see Setting a Temporary Update Path.

Check Network Connectivity

If the issue persists after setting a valid temporary update path directory, ensure that your server is able to connect to the WHMCS update mirrors.

Using your Server's SSH Command Line, run this command: 


curl -v https://releases.whmcs.com/v2/packages.json


Work with your server admin/hosting provider to resolve any errors which may be output.


An explanation of select error codes is provided in our documentation:


Failed to retrieve latest version
Check for Updates Failed: Failed to retrieve latest version: [ErrorException] Trying to access array offset on value of type null update


This error is experienced when operating WHMCS in an environment with a PHP version that is too high (for example, attempting to operate WHMCS 7.10 in a PHP 7.4 environment).


Refer to the PHP compatibility matrix and select a PHP version compatible with your current version of the WHMCS software.


Once the software update can be performed successfully, a compatible higher PHP version can be selected.