38.12. Configuring the Qmail Configuration Module
Like most other modules, this one has several settings that apply to the operation of the module itself rather than to Qmail. They are divided into two groups—those that affect the user interface, and those that specify the paths to Qmail configuration files and programs. When you click on the Module Config link on the main page, the first group of settings is listed under Configurable options while the second appears under System configuration.
Table 38.1 lists all of the available fields and explains what they do.
| Sort tables by | When Order in file is chosen, the lists of aliases, virtual mappings, domain routes, and mail users will be displayed in the order in which they appear in their source text files, which is typically the order in which they were added. If Name is chosen, however, they will be sorted by name instead, which can make individual entries much easier to find. |
| Maximum number of records to show in tables | If the number of entries in the list of aliases, virtual mappings, domain routes, or mail users exceeds the number in this field, they will not be shown. Instead, a search form will appear allowing you to find entries by name. This is done to prevent an extremely large alias file making the Mail Aliases page enormous and slow to display. On most small systems, the default limit of 200 will never be hit. |
| Mail messages to display per page | This field controls the number of email messages that appear per page in the users' mailboxes and when viewing the mail queue. You may want to increase it if you like to use a large browser window. |
| Send mail via connection to | As the Section 38.11 “Reading Users' Email” explains, this module can be used to compose and send email messages. When this field is set to qmail-inject executable, Webmin will send these messages by running the /var/qmail/bin/qmail-inject command and feeding it the email as input. Assuming your mail server is running properly, this should work fine. To have messages sent via an SMTP connection to some other MTA instead, select the second option for this field and enter another mail server's hostname into the text box. You can even enter localhost to have email sent via the Qmail server on this system, but using SMTP instead of running a program. |
| Mailbox format | If you have configured Qmail to store users' email in individual files under a directory (usually called Maildir), this field must be set to Directory. If a standard Sendmail-style file is used per user, then Single file must be chosen instead. |
| Minimum mail file size to index | When displaying the contents of a single file mailbox, Webmin creates an index file of messages that it contains so that it does not have to reread the mail file on every page. This speeds up the display of the mailbox and single email pages, but can break down if the mailbox changes often. A common symptom of index failure is the display of numerous blank messages instead of the actual contents of a mailbox. This field can be used to turn off indexing altogether, or limit it to only large mail files. The default of 1 MB stops the indexing of small mailboxes that are frequently cleared by POP3, while enabling it for large boxes that are left on the server. |
| Forward messages with quoting? | When this option is enabled (as it is by default), single messages forwarded using the module's mail reading feature will have > characters prepended to each line. Since some people don't like this form of quoting, this configuration field can be used to turn it off. |
| Sort mail queue by | This field controls the order in which messages in Qmail's mail queue are shown. The default is to sort by queue ID, but you can have the module sort by other attributes of each message instead—but at the cost of slowing down the display for a large queue. |
| Show size of mail queue on main page? | This field determines if the current size of the mail queue is shown on the module's main page below the mail queue icon. You may want to disable this if your system consistently has a large queue that Webmin is slow to count. |
| Confirm before deleting messages? | This field determines if Webmin will ask you for confirmation before deleting messages in a user's mailbox. |
| Qmail base directory | This field must be set to the base directory under which all the Qmail files and programs are located. This is pretty much always /var/qmail. |
| Sendmail mail file location | If the Mailbox format field is set to Single file, this field tells the module where to look for user mail files. If File under home directory is chosen, the module will use the filename from the next configuration field—usually Mailbox. If the second option is selected, however, you must enter a path (like /var/mail) into the box next to it. The module will then assume that Qmail delivers to files in this directory with the same names as their owners, just like Sendmail does. |
| Sendmail mail file in home directory | When using the Single file mailbox format, this file tells the module the name of the mail file in users' home directories. It should almost always be set to Mailbox. |
| Qmail maildir in home directory | When using the Directory mailbox format, this file tells the module the name of the Qmail mail subdirectory in users' home directories. It should almost always be set to Maildir. |
| Mail file directory style | If the Mailbox format field is set to Single file and the second option chosen in the Sendmail mail file location field, this menu tells the module how user mail files are laid out under the directory (usually /var/mail). The default of mail/username tells the module that mail files are in the directory and have the same name as the user who owns them. For 99 percent of systems, this is correct, and thus this field need not be changed. If you have a large number of users on your system, however, and have configured Qmail to group user mail files into subdirectories under /var/mail, then the other menu options will be useful. Their meanings should be self-explanatory. |
| Command to start Qmail | When the Start Qmail Processes button on the module's main page is clicked, this field is consulted to see which command to run. If Just run rc script is selected, the /var/qmail/rc script is used, which starts the qmail-send queue-processing daemon. If instead you select the second radio button, whatever command you enter into the adjacent text field will be run—it must be something that actually starts qmail-send though. |
| Command to stop Qmail | When the Stop Qmail Processes button on the module's main page is clicked, this field is consulted to see how to stop the qmail-send process. If Just kill qmail-send is selected, the module will kill all processes with that name. If you choose the second option and enter a command into its text field, however, that command will be run instead. |
The two most common Qmail configurations are delivery to the Mailbox file or Maildir directory in users' home directories. By default, the module is set up to read mail from ~/Maildir, but if you have set up Qmail to use the ~/Mailbox file instead you must change the Mailbox format field to Single file.
..................Content has been hidden....................
You can't read the all page of ebook, please click here login for view all page.