1DBMAIL.CONF(5) DBMAIL.CONF(5)
2
6 dbmail.conf - configuration file for DBMail, the Database Mailer.
7
9 There are 8 sections: DBMAIL, SMTP, LMTP, POP, IMAP, SIEVE, LDAP,
10 DELIVERY. The default config file already has documentation for all of
11 the settings.
12
14 [DBMAIL]
15 # Database settings
16 driver=pgsql # Supported drivers are mysql, pgsql, sqlite.
17 authdriver=sql # Supported drivers are sql, ldap.
18 host= # Host for database, set to localhost if database is on
19 # the same host as dbmail and you want to use a local
20 # socket for connecting.
21 sqlport= # If you want to use TCP/IP for connecting to the database,
22 # and have the database running on a non-standard port.
23 sqlsocket= # When using a local socket connection to the database, fill
24 # in the path to the socket here (e.g. /var/run/mysql.sock).
25 user=dbmail # Database username.
26 pass= # Database password.
27 db=dbmail # Database name.
28 table_prefix=dbmail_ # Table prefix. Defaults to "dbmail_" if not specified.
29 encoding=utf8 # Encoding to match database/table encoding, e.g., latin1, utf8
30 default_msg_encoding=utf8 # Default for messages without a known encoding, e.g., iso8859-1, utf8
31 postmaster= # Postmaster's email address for use in bounce messages.
33 sendmail=/usr/sbin/sendmail # Sendmail executable for forwards, replies, notifies, vacations.
34 # You may use pipes (|) in this command, for example:
35 # dos2unix|/usr/sbin/sendmail will work well with Qmail.
36 # You may use quotes (") for executables with unusual names.
37 # The following items can be overridden in the service-specific sections.
39 TRACE_SYSLOG=5 # Trace level to send to syslog. Default is 2 (messages, errors, fatals).
40 TRACE_STDERR=2 # Trace level to send to stderr. Default is 0 (fatals).
41 EFFECTIVE_USER=nobody # Root privs are used to open a port, then privs
42 EFFECTIVE_GROUP=nogroup # are dropped down to the user/group specified here.
43 BINDIP=* # The IP address the services will bind to.
44 # Use * for all local interfaces.
45 # Use 127.0.0.1 for localhost only.
46 # Multiple addresses may be separated by commas.
47 # IPv6 addresses are not yet supported.
48 NCHILDREN=2 # Default number of child processes to start.
49 MAXCHILDREN=10 # Maximum number of child processes allowed.
50 MINSPARECHILDREN=2 # Unused children to always have availale.
51 MAXSPARECHILDREN=4 # Maximum unused children allowed to be active.
52 MAXCONNECTS=10000 # Child process is restarted after handling this many connections.
53 MAX_ERRORS=500 # Child process will restart after this many connection errors.
54 TIMEOUT=300 # Idle time allowed before a connection is shut off.
55 RESOLVE_IP=yes # If yes, resolves IP addresses to DNS names when logging.
56 log=/var/log/dbmail.log # logfile for stdout messages
57 error_log=/var/log/dbmail.err # logfile for stderr messages
58 pid_directory=/var/run # directory for storing PID files
59 state_directory=/var/run # directory for storing the daemon statefiles
60 library_directory=/usr/lib/dbmail # directory for locating libraries
61 [SMTP]
63 # In fact, there isn't anything here by default.
64 [LMTP]
66 PORT=24 # Port to listen on.
67 BANNER=Hello I am LMTP # Override the LMTP banner to hide your DBMail version.
68 [POP]
70 PORT=110 # Port to listen on.
71 POP_BEFORE_SMTP=no # If yes, allows SMTP access from the host IP connecting by POP3.
72 BANNER=Hello I am POP3 # Override the POP3 banner to hide your DBMail version.
73 [IMAP]
75 PORT=143 # Port to listen on.
76 TIMEOUT=4000 # IMAP prefers a longer timeout than other services.
77 IMAP_BEFORE_SMTP=no # If yes, allows SMTP access from the host IP connecting by IMAP.
78 BANNER=Hello I am IMAP # Override the IMAP banner to hide your DBMail version.
79 [SIEVE]
81 PORT=2000 # Port to listen on.
82 BANNER=Hello I am SIEVE # Override the ManageSieve banner to hide your DBMail version.
83 [LDAP]
85 PORT=389
86 VERSION=3
87 HOSTNAME=ldap
88 BASE_DN=ou=People,dc=mydomain,dc=com
89 BIND_DN=cn=admin,dc=mydomain,dc=com
90 BIND_PW=password
91 SCOPE=SubTree
92 USER_OBJECTCLASS=top,account,dbmailUser
93 FORW_OBJECTCLASS=top,account,dbmailForwardingAddress
94 CN_STRING=uid
95 FIELD_PASSWD=userPassword
96 FIELD_UID=uid
97 FIELD_NID=uidNumber
98 MIN_NID=10000
99 MAX_NID=15000
100 FIELD_CID=gidNumber
101 MIN_CID=10000
102 MAX_CID=15000
103 FIELD_MAIL=mail
104 FIELD_QUOTA=mailQuota
105 FIELD_FWDTARGET=mailForwardingAddress
106 [DELIVERY]
108 SIEVE=yes # Run Sieve scripts as messages are delivered.
109 SUBADDRESS=yes # Use 'user+mailbox@domain' format to deliver to a mailbox.
110 SIEVE_VACATION=yes # Turn on/off the Sieve Vacation extension.
111 SIEVE_NOTIFY=no # Turn on/off the Sieve Notify extension (not supported).
112 SIEVE_DEBUG=no # Turn on/off additional Sieve debugging.
113 AUTO_NOTIFY=no # Use the auto_notify table to send email notifications.
114 AUTO_REPLY=no # Use the auto_reply table to send away messages.
115 #AUTO_NOTIFY_SUBJECT # Defaults to "NEW MAIL NOTIFICATION"
116 #AUTO_NOTIFY_SENDER # Defaults to POSTMASTER from the DBMAIL section.
117
120 If you experience inexplicable problems with DBMail, please report the
121 issue to the [1]DBMail Bug Tracker.
122
124 DBMail and its components are distributed under the terms of the GNU
125 General Public License. Copyrights are held variously by the authors
126 listed below.
127
129 DBMail is a collaborative effort among the core developers listed below
130 and the tremendous help of the testers, patchers and bug hunters listed
131 in the AUTHORS and THANKS files found in the DBMail source
132 distribution.
133 Eelco van Beek Aaron Stone Paul J Stevens
135 Roel Rozendaal Open Source Engineer NFG Net Facilities Group BV
136 Ilja Booij Palo Alto, CA USA http://www.nfg.nl
137 IC&S http://hydricacid.com
138 Koningsweg 4
139 3582 GE Utrecht
140 http://www.ic-s.nl
141
144 1. DBMail Bug Tracker
145 http://dbmail.org/index.php?page=bugs
146 10/16/2007 DBMAIL.CONF(5)