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

For cPanel & WHM version 68

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

Overview


Warnings:

  • 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 Assistant 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 space quotas on the directories in which your cPanel users store their files.

We recommend that you use quota support. Without quota support, the server will not display disk space usage for users and it will not enforce quota limits.

Important:

  • Quotas do not limit updates that a user can make to a MySQL®, MariaDB®, or PostgreSQL® database.
  • Quotas that include databases 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 situation occurs because the kernel-enforced quota does not access cPanel settings.

Notes:

  • The backup process for an account near or over its quota may fail because the system cannot write necessary files, such as a database lock file.
  • 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.

Warning:

  • 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 ignores /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