Update Dry Run Errors


While attempting to update WHMCS, you see the following Update Failed error, where x is the number of files and directories that the update process could not overwrite:

Apply update dry-run detected x permission issues

For more information about other Update Failed errors, see Update Failed Errors.


The Automatic Updater feature downloads, extracts, and copies the new files for each new version during updates. Before overwriting the existing files, it performs a dry-run test to check the existing file permissions.

If any permissions are incorrect, the update fails and the system returns this error message. If this occurs, the process will not change the WHMCS installation and will continue to operate on the original version.

The list of file paths under the error message indicates which permissions are incorrect. For example:

A failed dry run while updating.

In the above example, the dry-run test found permissions issues for the following files:

  • /var/www/html/whmcs/configuration.php.new
  • /var/www/html/whmcs/vendor/whmcs/whmcs-foundation/lib/Module


To resolve this error, update the permissions and ownership of the listed files and directories to allow PHP scripts on your server configuration to write to them.

Last modified: June 24, 2024