How to Fix Quotas

For cPanel & WHM version 11.40


The following steps will help you verify whether certain devices are properly configured for quotas. You will need to add quotas for any device that holds cPanel accounts and does not already have quotas enabled.

PICK Important: You must log in as the root user on your system before you begin.

Run the mount command

Run the mount command to obtain basic information about currently mounted file systems. When you run this command without any arguments, the system will print information for all of its mounted file systems.

The following example of the mount command output shows that the device /dev/mapper/VolGroup00-LogVol00 uses quotas.
PICK Important: Entries that contain usrquota are quota-enabled.

root@host [~]# mount
/dev/mapper/VolGroup00-LogVol00 on / type ext3 (rw,usrquota)
proc on /proc type proc (rw)
sysfs on /sys type sysfs (rw)
devpts on /dev/pts type devpts (rw,gid=5,mode=620)
/dev/sda1 on /boot type ext3 (rw)
tmpfs on /dev/shm type tmpfs (rw)
none on /proc/sys/fs/binfmt_misc type binfmt_misc (rw)
/usr/tmpDSK on /tmp type ext3 (rw,noexec,nosuid,loop=/dev/loop0)
/tmp on /var/tmp type none (rw,noexec,nosuid,bind)
sunrpc on /var/lib/nfs/rpc_pipefs type rpc_pipefs (rw)

note Note: To learn more about the mount command, visit the mount man page..

Examine the fstab file contents

The fstab (file systems table) file is a system configuration file that maps devices to their respective mount points within a system.

To display the contents of /etc/fstab, use the cat command:

cat /etc/fstab

The cat command will print the file output in the command line interface.
PICK Remember: Entries that contain usrquota are quota-enabled.


The fstab system configuration file is divided into six columns that each represent configuration options. These options determine the purpose of each file system and how it should mount.

Column Description
Device The physical device that contains the data.
Mountpoint The path to the device's data storage location. The mount point is a physical location in the partition that functions as the root of the filesystem.
FStype The type of file system. On most servers, ext3 is most often visible.
Options The mount options for the file system. These options include whether quotas are enabled and whether programs can be executed on the device. Examine this column to ensure that quotas are enabled for the device.
Dump The dump option. The dump backup utility uses this option. This value is not important for quotas.
Pass The fsck option. The fsck file checking utility uses this option. This value is not important for quotas.

note Note: To learn more about fstab, visit the fstab man page.

How to enable quotas

After you verify which devices do not have quotas enabled, use the following steps to enable quotas for the desired devices.

Specify quotas in the fstab file

If quotas are not enabled in /etc/fstab, use your preferred text editor to add the string usrquota to the Options column. You may only use spaces and tabs to create blank spaces between entries.

After you make changes to the fstab file, use the mount and remount commands to remount the file system. For example, to remount the /dev/mapper/VolGroup00-LogVol00 device you might issue the following command:

mount -o remount /dev/mapper/VolGroup00-LogVol00

note Note: In this command, -o argument allows you to pass an option to the mount utility. In this example, you pass the remount option and cause the mount utility to immediately remount the file system.

Verify that you enabled quota files

After you edit /etc/fstab, confirm that the quota files are located in the root directory ( /) and that each file is greater than 0 bytes.

Use the ls command with a wildcard, as shown in the following example:

root@host [/]# ls -l /*.user
-rwxr--r-- 1 root root 13312 Apr 26 16:39 /aquota.user*
-rwxr--r-- 1 root root    32 Apr 19 16:26 /quota.user*

note Notes:

  • The example above uses the ls command to list the contents of the root directory (/). The -l flag causes ls output to display in long listing format. This long listing format shows the file's permissions, which user owns the file, which group owns the file, the size of the file in bytes, and the date the file was last modified.
  • If these files do not exist, use the /scripts/initquotas utility to create them.

Ensure quotas report on the system

Use the following command to confirm that you successfully enabled quotas:

repquota -a

This command, when paired with the -a argument, will print all of the file systems listed in /etc/mtab with read/write and quota options enabled.

What if my quotas still do not function?

If you experience further problems, examine /var/cpanel/cpanel.config to ensure that the disablequotacache parameter is set to 0. To do this, run the following command:

grep 'disablequotacache' /var/cpanel/cpanel.config

note Note: The grep utility allows you to search for a string. In the command above, grep searches for diablequotacache in the /var/cpanel/cpanel.config file. The output should appear similar to:

root@host [~]# grep 'disablequotacache' /var/cpanel/cpanel.config

If the disablequotacache parameter is set to 1, edit the cpanel.config file with your preferred text editor and change the value to 0.

If you still experience problems with quotas, use our ticket system to submit a ticket.

A note about Virtuozzo®

If you use Virtuozzo, you will need to enable second-level (per-user) quotas in addition to first-level (per-container) quotas. You must enable second-level quotas from the parent node. For more information, visit our Virtuozzo quotas documentation.

Topic revision: r17 - 18 Oct 2013 - 17:04:42 - Main.LaurenceSimon
AllDocumentation/WHMDocs.HowToFixQuotas moved from Sandbox.HowToFixQuotas on 26 May 2011 - 18:59 by Main.JustinSchaefer - put it back