---
name: "cyrus-quota"
section: "8"
platform: "linux"
package: "cyrus-common"
version: "3.10.2-1+deb13u2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/cyrus-quota"
---

# cyrus-quota(8)

Cyrus IMAP documentation Report and optionally fix storage and message quota usage.

## NAME

quota - Cyrus IMAP documentation

Report and optionally fix storage and message quota usage.

## SYNOPSIS

```
quota [ -C config-file ] [ -d domain ] [ -f ] [ -u ] [ mailbox-spec... ]
```

## DESCRIPTION

**quota** *generates a report listing quota roots, giving their limits and* *usage.*

*If the* **-f** *option is specified,* **quota** *first fixes any* *inconsistencies in the quota subsystem, such as mailboxes with the wrong* *quota root or quota roots with the wrong quota usage reported.*

*If an optional domain is specified with the* **-d** *option, the quota* *listing (and any inconsistency fixing) is performed only in that domain* *rather than all mailboxes.*

*If one or more mailbox-spec arguments are specified, these are interpreted* *as mailbox prefixes, and the quota listing (and inconsistency fixing) is* *limited to quota roots with names that start with one of the given prefixes.* *If the* **-u** *is provided, mailbox-spec arguments are instead interpreted* *as userids, and the quota listing (and inconsistency fixing) is limited to* *quota roots for only the specified users.*

**WARNING:**

*Running* **quota** *with both the* **-f** *option and mailbox-spec* *arguments is not recommended.*

**quota** *reads its configuration options out of the [imapd.conf(5)](/imapd.conf/5.md) file unless specified otherwise by* **-C***.*

## OPTIONS

- **-C config-file**

  *Use the specified configuration file config-file rather than the default [imapd.conf(5)](/imapd.conf/5.md).*

- **-d domain, --domain domain**

  *List and/or fix quota only in domain.*

- **-f, --fix**

  *Detect and fix any inconsistencies in the quota subsystem before generating* *a report.*

- **-n, --report-only**

  *Check for any inconsistencies in the quota subsystem but don't actually* *fix them.  Use with* **-f** *and* **-q** *to only see what's incorrect.*

- **-q, --quiet**

  *Operate quietly. If* **-f** *is specified, then don't print the quota* *values, only print messages when things are changed.*

- **-J, --json**

  *Output the quota values as JSON for automated tooling support*

- **-u, --userids**

  *Interpret mailbox-spec arguments as userids.  The default is to* *interpret them as mailbox prefixes*

- **mailbox-spec**

  *Only report and/or fix quota in mailboxes matching the specified* *mailbox-spec arguments.  See also* **-u***.*

## EXAMPLES

```
quota
```

**List quotas for all users and mailboxes.**

## FILES

**/etc/imapd.conf**

## SEE ALSO

*[imapd.conf(5)](/imapd.conf/5.md)*

## AUTHOR

**The Cyrus Team, Jeroen van Meeuwen (Kolab Systems), Nic Bernstein (Onlight)**

## COPYRIGHT

**1993–2025, The Cyrus Team**