Child pages
  • The cpanelsync.exclude File
This documentation is for cPanel & WHM version 84 CURRENT builds.  The "RELEASE" version of our documentation can be found in the Version 82 Documentation space.

Skip to end of metadata
Go to start of metadata


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