---
name: "cvm-qmail"
section: "8"
platform: "linux"
package: "cvm"
version: "0.97-3"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/cvm-qmail"
---

# cvm-qmail(8)

qmail configuration lookup module

## NAME

cvm-qmail - qmail configuration lookup module

## SYNOPSIS

cvm-qmail

## CREDENTIALS

None, only operates as a lookup module.

## DESCRIPTION

This module uses the standard qmail configuration files to determine if an address is valid, using the same lookups that qmail would. It first checks *control/locals* and then *control/virtualdomains* to determine if the domain is valid, and to determine the prefix to add to virtual domain usernames. It then looks up the resulting username in *users/cdb* (or the system password table if the CDB does not exist) to determine the correct home directory. If the address would require a *.qmail-something* file, it ensures that that file exists as well, doing *-default* checks as necessary.

## CONFIGURATION VARIABLES

- **CVM\_QMAIL\_MISSINGDOMAIN (optional)**

  If this is set and the domain name is not a local or virtual qmail domain, this domain name is substituted and the lookup succeeds. This allows for setups where domains listed in *control/rcpthosts* and *control/morercpthosts.cdb* (which are accepted by the SMTP receiver) are not listed as local or virtual domains. If this is set to an empty value, "localhost" is substituted.

- **CVM\_QMAIL\_MISSINGUSER (optional)**

  When missing domain substitution is being done, the value of this variable is used to replace the username. The value must exist as a valid system user. Defaults to "alias" which will normally exist on all qmail systems.

- **QMAIL\_ROOT (optional)**

  The root directory under which all the qmail configuration files are expected to be found. Defaults to "/var/qmail", which is the normal qmail install path.

## SEE ALSO

[cvm-pwfile(8)](/cvm-pwfile/8.md), [cvm-unix(8)](/cvm-unix/8.md), cvm-sql(8), [cvm-vmailmgr(8)](/cvm-vmailmgr/8.md), [cvm-benchclient(8)](/cvm-benchclient/8.md), [cvm-checkpassword(8)](/cvm-checkpassword/8.md), [cvm-testclient(8)](/cvm-testclient/8.md)

 http://untroubled.org/cvm/cvm.html