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:
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.
The following warning will appear:
Click Configure Update Settings in the top-right corner.
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:
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.