Eric's Tech Notes: qmail

Qmail Configuration

(Using files in /var/qmail/control)

Control File	Default	Used by	Purpose
badmailfrom	none	qmail-smtpd	blacklisted From addresses
bouncefrom	MAILER-DAEMON	qmail-send	username of bounce sender
bouncehost	me	qmail-send	hostname of bounce sender
concurrencyincoming	none	/service/qmail-smtpd/run	max simultaneous incoming SMTP connections
concurrencylocal	10	qmail-send	max simultaneous local deliveries Maximum number of simultaneous local delivery attempts. If 0, local deliveries will be put on hold. concurrencylocal is limited at compile time to 509.
concurrencyremote	20	qmail-send	max simultaneous remote deliveries Maximum number of simultaneous remote delivery attempts. If 0, remote deliveries will be put on hold. concurrencyremote is limited at compile time to 509.
defaultdelivery	none	/var/qmail/rc	default .qmail file
defaultdomain	me	qmail-inject	default domain name
defaulthost	me	qmail-inject	default host name
databytes	0	qmail-smtpd	max number of bytes in message (0=no limit)
doublebouncehost	me	qmail-send	host name of double bounce sender
doublebounceto	postmaster	qmail-send	user to receive double bounces
envnoathost	me	qmail-send	default domain for addresses without "@"
helohost	me	qmail-remote	host name used in SMTP HELO command
idhost	me	qmail-inject	host name for Message-ID's
localiphost	me	qmail-smtpd	name substituted for local IP address
locals	me	qmail-send	domains that we deliver locally
me			FQDN of system various default for many control files
morercpthosts	none	qmail-smtpd	secondary rcpthosts database
percenthack	none	qmail-send	domains that can use "%"-style relaying
plusdomain	me	qmail-inject	domain substituted for trailing "+"
qmqpservers	none	qmail-qmqpc	IP addresses of QMQP servers
queuelifetime	604800	qmail-send	seconds a message can remain in queue This file defines how long your server will attempt to process or deliver an email before bouncing it to the originating sender defined in the header of the email message. The value is in seconds. Once the maximum time has been met the message will bounce, with the new sender being defined in bouncefrom and coming from the domain defined in bouncehost. (86400 = one day).
rcpthosts	none	qmail-smtpd	domains that we accept mail for
smtpgreeting	me	qmail-smtpd	SMTP greeting message
smtproutes	none	qmail-remote	artificial SMTP routes
timeoutconnect	60	qmail-remote	how long, in seconds, to wait for SMTP connection
timeoutremote	1200	qmail-remote	how long, in seconds, to wait for remote server
timeoutsmtpd	1200	qmail-smtpd	how long, in seconds, to wait for SMTP client
virtualdomains	none	qmail-send	virtual domains and users

Tell qmail to re-read '/etc/qmail/virtualdomains':

	$ sudo killall -HUP qmail-send

/etc/qmail config files:

badmailfrom-unknown - When given, this is a list of THE ONLY e-mail domain-name origins for which DNS reverse-resolution checks will be done- for all other e-mails, no PTR RR check will be done will be done.
```
	@hotmail.com
	@yahoo.com
```

badrcptto - e-mail addresses used as "traps" to catch spammers' webspiders

	not.a.real.address@my-example-domain.com
	posted.in.an.html.comment@my-example-domain.com

custombouncetext
```
	Bounce, bounce, bounce...
```
databytes - set maximum size (in bytes) of a mail message. for 10megs:
```
	10000000
```
defaultdelivery - enable Maildir delivery here
```
	./Maildir/
```
locals - domain-names which should be delivered to local UNIX accounts:
```
	my-example-domain.com
	www.my-example-domain.com
```
me - how the mailserver identifies itself to others:
```
	my-example-domain.com
```

rcpthosts - domain-names we will accept mail FOR:

	localhost
	my-example-domain.com
	www.my-example-domain.com
	my-friends-domain.com

relaymailfrom - a way to force the server to relay mail arriving from any host, as long as it's sent with a good "From:"
```
	bob@bobs-example-domain.com
```
signatures

smtpgreeting - optional:

	mydomainname.com Greetings e-mail user!

users - directory

virtualdomains - forward ALL mail for a domain-name to a single UNIX user:

	bobs-example-domain.com:bob
	ftp.bobs-example-domain.com:bob
	www.bobs-example-domain.com:bob

Portions taken from the man page for qmail-send.