Guides & TutorialsUpdating WHMCS TroubleshootingTroubleshooting an Apply update dry-run permission issues Error

Troubleshooting an Apply update dry-run permission issues Error

Introduction

An Apply update dry-run detected x permission issues error, where x is the number of files and directories that the update process could not overwrite, may occur in the Auto Update window in WHMCS:

Insufficient FIle Permissions Error: Apply update dry-run permission issues

The contents of the error message can help you identify and resolve the underlying causes of this error.

Background

The automatic update tool is a feature that downloads, extracts, and copies the new files, overwriting the existing files. It performs a dry run test (a test that mitigates the effects of a possible failure) to check the file permissions of all existing files before attempting the overwrite operation.

The dry run simulates overwriting the file without making any file changes. If it encounters a permission problem that could cause the update process to fail, the update process stops before making any changes.

In this case, an error message displays with the details of the file permission issues.

If this occurs, the process will not change the WHMCS installation and will continue to operate on the original version.

Interpreting the Error Message

Under the Apply update dry-run detected x permission issues error, where x is the number of files and directories that the process could not overwrite, the system displays the full paths of each file. 

For example:

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

Resolving the Error

To resolve this error, update the permissions and ownership of the itemised files and directories to allow PHP scripts on your server configuration to write to them, or ask your system administrator or hosting provider.

For more information on making these changes, see:

After you have updated the permissions and ownership, you can start the update process again by navigating to Utilities > Update WHMCS and clicking Update Now.

For More Information

For more information about using the automatic update tool, see: