You can find our user documentation at

Check out our new API beta site!

Page tree
Skip to end of metadata
Go to start of metadata

For cPanel & WHM version 58

(Home >> Server Configuration >> Initial Quota Setup)



  • Servers that use the XFS® filesystem and run CentOS 7, CloudLinux™ 7, or Red Hat® Enterprise Linux (RHEL) 7 require additional actions for quotas to function properly:
    • WHM Interface — After you enable quotas in WHM's Initial Setup Wizard interface and the system performs the necessary configuration changes, a button appears in the top right corner of the WHM interface. You must click this button to reboot the system. After the system reboots, a quota scan runs in the background to complete the process.
    • Command Line — Run the /scripts/fixquotas script and then reboot the server.
    • Manually via the Command Line — For instructions on how to perform the /scripts/fixquotas script's actions manually, the Red Hat XFS  and XFS Quota Management  documentation.
    If you have enabled Quota System Administration notifications, the system sends notifications when it is ready to reboot and when the quota scan finishes and quotas are functional.
  • CloudLinux 7 updates may break quotas. For this reason, after each CloudLinux 7 update, you must run the /scripts/fixquotas script and then reboot the server.

The Initial Quota Setup interface scans your server to confirm that it uses disk quotas on the directories in which your cPanel users store their files.

We recommend that you use quota support. Without quota support, users appear to use no disk space and the server will not enforce quota limits.


  • Quotas do not limit updates that a user can make to a MySQL, MariaDB, or PostgreSQL® database.
  • Quotas that include database space only affect cPanel-related functions.
  • Processes that the system runs, such as PHP scripts that create files, can create user-owned files until the number of files reaches the quota. This is because the kernel-enforced quota is not aware of cPanel settings.


If you run a Virtuozzo® Virtual Private Server (VPS), read our Enable Quotas on a Virtuozzo® VPS documentation.

Quota setup

To perform the quota scan, click Proceed.


  • This feature requires kernel support for quotas on your server. If your server uses a custom kernel that does not include quota support, the initial quota setup process may result in an unbootable system.
  • When you click Proceed, the system runs the /scripts/initquota script. This script skips /home directory mount points that use the following options:
    • no
    • no auto
    • loop
      To troubleshoot this issue, open the /etc/fstab file with a text editor and check for these options.


Additional documentation