qpsmtpd Wiki


You are here: start » config » configuration_files


You are currently not logged in! Enter your authentication credentials below to log in. You need to have cookies enabled to log in.


You don't have an account yet? Just get one: Register

Forgotten your password? Get a new one: Set new password

Configuration files

qmail & qpsmtpd configuration files

qpsmtpd was originally designed as a drop-in replacement for qmail-smtpd, so it will read the following qmail configuration files.

These files will be read from either the qmail configuration direct at (/var/qmail/control, by default) or qpsmtpd's own config directory (config/). The config directory is assumed to be within the path of the enviroment variable (QPSMTPD_CONFIG).


The file config/IP is used on startup to decide what IP address qpsmtpd should bind to.


The file config/me is used by qpsmtpd to set the name the server is known by. This should be a FQDN that resolves to an IP address of the server. There is no default, this file must exist.


The file config/databytes determines the maximum size of messages qpsmtpd will accept, in bytes. The default is not to have a limit (except memory and storage limitations, of course). This file is used by lib/Qpsmtpd/SMTP.pm.


If the file config/require_resolvable_fromhost contains anything but a 0 on the first line, envelope senders will be checked against DNS. If an A or a MX record can't be found the mail command will return a soft rejection (450).


The file config/smtpgreeting overrides the default SMTP greeting displayed to whatever text is in this file. Default is hostname and version of qpsmtpd running.


The file config/spool_dir can contain the name of a directory that will be the spool directory qpsmtpd uses during the data transactions. If this file doesnt exist, it will default to use $ENV{HOME}/tmp/. This directory should be set with a mode of 700 and owned by the smtpd user.


The file config/timeoutsmtpd (same as for qmail) specifies the number of seconds to wait for a response from the remote client before timing it out and closing connection. It defaults to 1200 seconds.