The balance_linked_node_quotas Script

Valid for versions 88 through the latest version



Last modified: May 13, 2020


The /usr/local/cpanel/scripts/balance_linked_node_quotas script lets you enforce disk use quotas for distributed cPanel accounts. These accounts use linked cPanel & WHM nodes. The system aggregates the disk usage for each cPanel account from the both the parent node and its child nodes. The script then adjusts each cPanel account’s disk use quota on both the parent and child nodes. The quota is closer to the actual disk space the cPanel account uses on each server. This helps ensure that distributed cPanel accounts do not exceed their quota limits.

For example, you have a cPanel user with a disk use quota of 10 gigabytes (GB). This account uses 7.5 GB for mail services. You decide to offload the mail services to a cPanel & WHM child node. When you run this script, the system assigns 75% of the user’s disk quota to the child node, and 25% to the parent node.

Run the script

To run this script on the command line, use the following format:

/usr/local/cpanel/scripts/balance_linked_node_quotas [options]


Use the following options with this script:

Options Description Example
--verbose Run the script in verbose mode. --verbose
--help Displays the help documentation. --help

Additional Documentation