Using Qmail

The first step is to edit the rcpthosts file (usually located in the /var/qmail/control directory) and add one line for the primary domain name running Vorras Mailer. Your rcpthosts file should contain the following line:

yourdomain.com

The second step is to configure qmail to direct all email for yourdomain.com to one user. Edit the virtualdomains file (typically located in the /var/qmail/control directory) as follows: type the name of the domain, yourdomain.com followed by a colon (:) and the name of the system user who will receive all email for the domain. For example assuming that the use is 'exampleuser', the following line should be placed in the virtualdomains file:

yourdomain.com:exampleuser-yourdomain-com

Note that there has to be an entry for the 'exampleuser' user in /etc/passwd and 'exampleuser' should have a home directory, e.g. '/home/exampleuser'. All email coming in to any-username@yourdomain.com will be forwarded to exampleuser@yourdomain.com and will be delivered according to the rules found in /home/exampleuser/.qmail-default. The .qmail-example-com-default file is used to send the email directly to the dispatch.py script found in the Vorras Mailer distribution. The contents of the .qmail-example-com-default file should be:

path/to/dispatch.py $EXT@$HOST

After completing the above steps you should restart Qmail and test if delivery works properly by sending email to a user.

If the above procedure does not work check the Qmail's logfiles, typically located at /var/log/maillog. Execute a tail -f /var/log/maillog command and try to see what was the error reported.

A common problem arises when the dispatch.py script invoked by qmail does not have the correct file permissions to write to the users data directory, and mail delivery will fails. In this case you may need to change permissions in the data directory hierarchy to ensure that the dispatch.py script has the right permissions to append new email to user accounts.