Update Failed Errors

Problem

An automatic update failed with the following error message:

Update Failed

An error occurred that prevented the update from completing successfully.

Cause

You can find the cause of the issue by examining the full output below the error message. Often, this is immediately following the [RuntimeException] label. For example:

An Update Failed error.

In the example above, the error indicates that a directory didn’t exist and the system could not create it. This is a permissions-related error.

The following issues are the most common causes of automatic update failures:

Error MessageDescriptionSolution
A fatal error occurred while fetching the update. Please check to make sure your memory limits and execution time are set to the recommended values.The update process timed out.
For steps to troubleshoot and resolve this issue, see Fatal Error Fetching Update.
cURL error 28: Operation timed out after 300000 milliseconds with xxxxxx out of yyyyy bytes receivedDue to a network connectivity issue, the system could not download the required update files within the 300 second time limit.
For steps to troubleshoot and resolve this issue, see Update Timed Out Errors.
Error: Apply update dry-run permission issuesThis is a permissions issue that is preventing the Automatic Update feature from writing to, executing, or deleting files in the WHMCS directory.Make certain that the user under which WHMCS runs has full permissions to the WHMCS installation’s directory.
For more information, see Update Dry Run Errors.
Error: chmod() has been disabled for security reasonsThis indicates that the chmod() PHP function is disabled in your PHP configuration.Enable the chmod() function in your PHP configuration.
For help, contact your hosting provider or system administrator.
Error: chmod(): Operation not permittedThis is a permissions issue that is preventing the Automatic Update feature from writing to, executing, or deleting files in the WHMCS directory.Make certain that the user under which WHMCS runs has full permissions to the WHMCS installation’s directory.
[ErrorException] file_put_contents(/path/to/file): failed to open steam: Permission DeniedThis is a permissions issue that is preventing the Automatic Update feature from writing to, executing, or deleting files in the WHMCS directory.Make certain that the user under which WHMCS runs has full permissions to the WHMCS installation’s directory.
[ErrorException] mkdir(): Permission deniedThis is a permissions issue that is preventing the Automatic Update feature from writing to, executing, or deleting files in the WHMCS directory.Make certain that the user under which WHMCS runs has full permissions to the WHMCS installation’s directory.
[ErrorException] ZipArchive::extractTo(/path/to/file.php): failed to open stream: Disk quota exceeded updateThis error indicates that you exceeded the available disk space in your hosting account.Increase your disk space allowance and try again.
For help, contact your hosting provider or system administrator.
[RuntimeException] /path/to/directory does not exist and could not be createdThis error may occur due to insufficient free disk space or a permissions issue.Make certain that the user under which WHMCS runs has full permissions to the WHMCS installation’s directory. Additionally, make sure that you have at least 250 MB of available disk space before attempting an update.
[RuntimeException] Could not delete /path/to/file.phpThis is a permissions issue that is preventing the Automatic Update feature from writing to, executing, or deleting files in the WHMCS directory.Make certain that the user under which WHMCS runs has full permissions to the WHMCS installation’s directory.
The temporary update path is not valid. Please specify a writable temporary update path to proceed with update.The system cannot write to the configured temporary update path.Go to Utilities > Update WHMCS and specify a valid absolute path for Temporary Update Path.
[WHMCS\Exception] Unable to copy /path/to/file.php to /path/to/file.php.This is a permissions issue that is preventing the Automatic Update feature from writing to, executing, or deleting files in the WHMCS directory.Make certain that the user under which WHMCS runs has full permissions to the WHMCS installation’s directory.

Last modified: June 5, 2024