Check for Updates Failures

Problem

You see the following error at Configuration () > System Logs during the daily automation tasks:

Check for Updates Failed

If there is no error but checking for updates does not display the new version, see New Version Not Appearing.

Cause

You can determine the cause of the error using the details in the log message.

Unable to Connect Error

The following error indicates problems connecting to the WHMCS update servers:

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

Temporary Update Path

To resolve the connection issue, set a temporary update path:

  1. Go to 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.

  2. Click Configure Update Settings in the top-right corner.

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

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

  4. Click Save Changes.

For more information, see Temporary Update Path.

Connectivity

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

To do this, run the following commands on the server that hosts your WHMCS installation:

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

curl -v https://pki.whmcs.com/

If these commands return anything other than StatusCode: 200, work with your system administrator or hosting provider to investigate the connectivity problem between your server and the WHMCS update server.

For example, a Message cURL error 77: Problem with the SSL CA cert (path? access rights?) error indicates that the server was unable to connect to the WHMCS update server because it could not verify the security of the connection. To resolve this, update the root CA bundles on your server.

For more information, see the libcurl error codes documentation.

Failed to Retrieve Latest Version Error

The following error indicates that your PHP version is too high for your version of WHMCS:

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

For example, you might see this if you attempt to operate WHMCS 8.5 in a PHP 8.1 environment.

To resolve this issue, make certain that your server runs a supported PHP version for your version of WHMCS.

For more information, see System Requirements.
troubleshooting updates

Last modified: October 30, 2024