The cpanelsync.exclude File

Last modified: July 24, 2019


Use the /etc/cpanelsync.exclude file to prevent updates to cPanel-distributed files. This method causes fewer problems than other methods of update prevention (for example, the use of the immutable state).

  • This method only prevents an update from the cpanelsync utility. It does not prevent updates that occur at application runtime.
  • You cannot use the cpanelsync.exclude file to prevent modifications to configuration files, datastores, or similar types of files.
  • You cannot block updates to RPM-managed files within the /etc/cpanelsync.exclude and /etc/cpanelsync.no_chmod files.
    • For more information about custom cPanel RPMs, read our How to Build and Install Custom RPMs documentation.
    • To determine whether an RPM manages a particular file, run the following command:
      rpm -qf /path/to/file


Each entry in the /etc/cpanelsync.exclude file must use an absolute path, with each path on its own line.

For example, you may wish to prevent an update to the following files:


Use the following commands to add the files’ path to the /etc/cpanelsync.exclude file:

echo "/usr/local/cpanel/scripts/pkgacct" >> /etc/cpanelsync.exclude
echo "/usr/local/cpanel/Cpanel/" >> /etc/cpanelsync.exclude

Additional Documentation