Child pages
  • The cpanelsync.exclude File
For cPanel & WHM version 76

Skip to end of metadata
Go to start of metadata

Overview

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).

Notes:

  • 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

Entries

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:

/usr/local/cpanel/scripts/pkgacct
/usr/local/cpanel/Cpanel/Logd.pm

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/Logd.pm" >> /etc/cpanelsync.exclude

Additional documentation