Admin Guide ( Unix System Administration) QMail Configuration

Qmail is an Internet Mail Transfer Agent (MTA) for UNIX-like operating systems. Qmail uses the Simple Mail Transfer Protocol (SMTP) to exchange messages with MTA's on other systems. To configure qmail, log in as admin and select System Administration in the CP+ Admin Mode section of the left panel in your admin CP+, then select QMail Configuration icon in the E-mail Management section.

Qmail Options qmail configuration files. Mail Aliases configures mail aliases for local email addresses. Virtual Mappings specifies options for virtual domains. Local Domains specifies the domains for which qmail will accept local mail delivery. Accepted Domains list of accepted domains. Rejected Addresses list of rejected email addresses. Domain Routing options of artificial SMTP routes. % Address Domains list of domains which suppot % addresses. Mail User Assignments assigns addresses to users. Mail Queue list of outgoing messages and recipients. User Mailboxes list of mailboxes with access to mail in them.

Qmail Options

Hostname for SMTP HELO: current host name, for use solely in saying hello to the remote SMTP server. SMTP connection timeout: number of seconds qmail will wait for the remote SMTP server to accept a connection. Default: 60. SMTP outgoing response timeout: number of seconds qmail will wait for each response from the remote SMTP server. Default: 1200.

Maximum message size: maximum number of bytes allowed in a message, or 0 for no limit. Default: 0. SMTP incoming data timeout: number of seconds qmail will wait for each new buffer of data from the remote SMTP client. Default: 1200. Hostname for email to local IP address: replacement of host name for local IP addresses. SMTP greeting message: the first word of smtp greeting message should be the current host's name.

Make sure to click Save to preserve changes. Mail Aliases Aliases - format of the qmail alias database. The aliases file provides a system-wide mechanism to redirect mail for local recipients.

Address: an address to be aliased must not include its domain name, it must be ksmith instead of ksmith@example.com. Alias To: each alias may redirect mail to several recipients, and each recipient may be one of the following: Email Address - a full email address (with domain name) or local address (without domain name). Mail Directory - pathname to the directory with user's email. Mail File - email will be written to the specified file. To have all email to some address thrown away, give /dev/null as the filename. Feed to Program- pathname to a program that starts each time an email message comes from this address and takes the message as its standard input. Autoreply From File - simply sends a mail automatically back to the sender containing whatever is in the file listed in the text field.

Virtual Mappings Virtual mappings are used by qmail to handle email to different domains on server, by prepending text to the user part of the email address before further processing. It can be used to setup virtual mail domains by creating a new virtual mapping for a domain, then using the Mail Aliases page to create aliases within that domain.

Mail for address: specifies addresses for which virtual mappings will be used.

Prepend to username: a virtual user has the form user@domain:prepend, when qmail sees the recipient address user@domain, it converts it to prependuser@domain and treats it as local.

Local Domains Qmail will accept for delivery to local users email to the domains and hostnames listed in the given text box. If you want your mail server to handle multiple email domains, they should all be listed on this form.

Make sure to click Save to preserve changes. Accepted Domains Qmail will accept for relaying or local delivery only mail to domains and hostnames listed in the given text box. You can also enter wildcards that match all hosts in a domain like .foo.com.

Make sure to click Save to preserve changes. Rejected Addresses Qmail will reject mail for delivery or relaying from any of the addresses listed in the given text box, which must be entered as username@domainname. If you want to reject mail from an entire domain, it should be entered as @domainname.

Make sure to click Save to preserve changes. Domain Routing This option allows to define a special transfer method for mail to certain domains.

Enter the information into the given form and make sure to click Create/Save to preserve changes.

% Address Domains Qmail will accept email with addresses in the format user%firstdomain@seconddomain if the seconddomain is listed in the given text box. Messages in this format will then be forwarded on to user@firstdomain by this mail server.

Make sure to click Save to preserve changes. Mail User Assignments Creates mailboxes for users that are not defined in the Unix user list. Each assignment will deliver mail for a chosen username or username pattern, as though it was being delivered to a real Unix user's mailbox.

Address username: specifies the assignment.There are two kinds of assignments: simple and wildcard. Unix user: enter the name of unix user you are creating mailboxe for or click the "..." button and find it in the pop-up window. Home directory: enter the path to the home directory or click the "..." button and find it in the pop-up window.

Mail Queue This module scans the outgoing queue of messages. For each message it prints various information, including the date the message entered the queue, the number of bytes in the message, the message sender, and all the recipients still under consideration. User Mailboxes Click the User Mailboxes icon and you will see the page, that contains the user mailboxes list:

To get access to mails in these mailboxes, just click one of mailboxes names in this list. To read mail in some file enter the name to this file or click the "..." button and find it in the pop-up window.