QUOTA(8)

📦 version 3.8.8, in opensuse-leap 16.0

🌸 NAME 🌸

okay so bestie, welcome to quota(8) — the Cyrus IMAP documentation page for the quota command. 💖 It's the one that reports and optionally fixes storage and message quota usage. Periodt.

🛠️ SYNOPSIS 🛠️

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

💅 DESCRIPTION 💅

So quota generates a report listing quota roots, and it gives you their limits and usage. Slay.

If you pass the -f option, quota first fixes any inconsistencies in the quota subsystem — think mailboxes with the wrong quota root, or quota roots with the wrong quota usage reported. Yep, it cleans that up before doing the report. ✨

If you specify an optional domain with the -d option, then the quota listing (and any inconsistency fixing) is performed only in that domain instead of all mailboxes.

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

WARNING: Running quota with both the -f option and mailbox-spec arguments is not recommended. Like, don't do that combo, bestie. 🙈

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

✨ OPTIONS ✨

  • -C config-file — Use the specified configuration file config-file rather than the default imapd.conf(5).
  • -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. Easy. Iconic. 💅

🗂️ FILES 🗂️

  • /etc/imapd.conf

👀 SEE ALSO 👀

👑 AUTHOR 👑

The Cyrus Team, Jeroen van Meeuwen (Kolab Systems), Nic Bernstein (Onlight). Absolute legends. 🫶

1993–2026, The Cyrus Team.

mwah 💋 — this little legend is from Cyrus IMAP version 3.8.8, dated Sep 09, 2026. Bestie, go check those quotas. 🦋

📦 where this page comes from