---
name: "deliverquota.courier"
section: "8"
platform: "linux"
package: "courier-base"
version: "1.4.1-3+deb13u2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/deliverquota.courier"
---

# deliverquota.courier(8)

deliver to a maildir with a quota

## NAME

deliverquota - deliver to a maildir with a quota

## SYNOPSIS

**deliverquota** \[-c\] \[-w *percent*\] \[-W *filename*\] {*maildir*} {*quota*}

## DESCRIPTION

**deliverquota** delivers mail to a *maildir* taking into account any software-imposed quota on the maildir. This manually-enforced quota mechanism is described in the [**maildirquota**(7)](/maildirquota/7.md)\[1\] and [**maildirmake**(1)](/maildirmake/1.md)\[2\] manual pages. Instead of setting up your mail server to deliver the message directly to a maildir, configure the mail server to run the **deliverquota** program in order to deliver the message, and specify the location of the maildir as the argument to **deliverquota**.

The second argument to **deliverquota** is optional. If present, *quota* specifies a new quota setting for this maildir. Specifying *quota* is equivalent to running [**maildirmake**(1)](/maildirmake/1.md)\[2\] with the **-q** option. The second argument to **deliverquota** is considered obsolete, and may be removed in the future.

**deliverquota** reads the message from standard input and delivers it to *maildir*. *maildir* may specify a path directly to a maildir folder, not the main *maildir* (as long as the folder was created by the [**maildirmake**(1)](/maildirmake/1.md)\[2\] command.

The **-c** option automatically creates the maildir, and all missing parent subdirectories (as '**mkdir -p**'). This option should be used with caution.

The **-w N** option places a warning message into the maildir if the maildir has a quota setting, and after the message was successfully delivered the maildir was at least *N* percent full. The warning message is copied from the file specified by the **-W** option, or from /etc/courier/quotawarnmsg if **-W** was not specified. The "Date:" and "Message-Id:" headers are added to the message. The warning is repeated every 24 hours (at least), until the maildir drops below *N* percent full.

## RETURN CODE

**deliverquota** delivers the message to the maildir and terminates with exit code 0 if the message can be delivered without going over quota.

If the maildir is over its specified quota: the maildrop version of **deliverquota** terminates with an exit code 77 (EX\_NOPERM); the Courier version of **deliverquota** terminates with an exit code 75 (EX\_TEMPFAIL).

## SEE ALSO

[**maildirquota**(7)](/maildirquota/7.md)\[1\], [**maildirmake**(1)](/maildirmake/1.md)\[2\].

## AUTHOR

**Sam Varshavchik**

Author

## NOTES

- 1\.

  [**maildirquota**(7)](/maildirquota/7.md)

  http://www.courier-mta.org/maildirquota.html

- 2\.

  [**maildirmake**(1)](/maildirmake/1.md)

  http://www.courier-mta.org/maildirmake.html