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 # (c) 2000-2006 IC&S, The Netherlands
15 #
16 # Configuration file for DBMAIL
17 [DBMAIL]
19 #
20 # Database settings
21 #
22 #
24 # Supported drivers are mysql, pgsql, sqlite.
25 #
26 driver =
27 #
29 # Supported drivers are sql, ldap.
30 #
31 authdriver =
32 #
34 # Host for database, set to localhost if database is on
35 # the same host as dbmail and you want to use a local
36 # socket for connecting.
37 #
38 host =
39 #
41 # If you want to use TCP/IP for connecting to the database,
42 # and have the database running on a non-standard port.
43 #
44 sqlport =
45 #
47 # When using a local socket connection to the database, fill
48 # in the path to the socket here (e.g. /var/run/mysql.sock).
49 #
50 sqlsocket =
51 #
53 # Database username.
54 #
55 user = dbmail
56 #
58 # Database password.
59 #
60 pass =
61 #
63 # Database name.
64 #
65 db = dbmail
66 #
68 # Table prefix. Defaults to "dbmail_" if not specified.
69 #
70 table_prefix = dbmail_
71 #
73 # encoding must match the database/table encoding.
74 # i.e. latin1, utf8
75 encoding = utf8
76 #
78 # messages with unknown encoding will be assumed to have
79 # default_msg_encoding
80 # i.e. iso8859-1, utf8
81 default_msg_encoding = utf8
82 #
84 # Postmaster´s email address for use in bounce messages.
85 #
86 #postmaster = DBMAIL-MAILER
87 #
89 # Sendmail executable for forwards, replies, notifies, vacations.
90 # You may use pipes (|) in this command, for example:
91 # dos2unix|/usr/sbin/sendmail works well with Qmail.
92 # You may use quotes (") for executables with unusual names.
93 #
94 sendmail = /usr/sbin/sendmail
95 #
97 #
98 # The following items can be overridden in the service-specific sections.
99 #
100 #
101 #
103 # Trace level to send to syslog. Default is 2 (messages, errors, fatals).
104 #
105 TRACE_SYSLOG = 3
106 #
108 # Trace level to send to stderr. Default is 0 (fatals).
109 #
110 TRACE_STDERR = 1
111 #
113 # Root privs are used to open a port, then privs
114 # are dropped down to the user/group specified here.
115 #
116 EFFECTIVE_USER = dbmail
117 EFFECTIVE_GROUP = dbmail
118 #
120 # The IP addresses the services will bind to.
121 # Use * for all local interfaces.
122 # Use 127.0.0.1 for localhost only.
123 # Separate multiple entries with spaces ( ) or commas (,).
124 #
125 BINDIP = *
126 #
128 # Default number of child processes to start.
129 #
130 NCHILDREN = 2
131 #
133 # Maximum number of child processes allowed.
134 #
135 MAXCHILDREN = 10
136 #
138 # Unused children to always have availale.
139 #
140 MINSPARECHILDREN = 2
141 #
143 # Maximum unused children allowed to be active.
144 #
145 MAXSPARECHILDREN = 4
146 #
148 # Child process is restarted after handling this many connections.
149 #
150 MAXCONNECTS = 10000
151 #
153 # Child process will restart after this many connection errors.
154 #
155 MAX_ERRORS = 500
156 #
158 # Idle time allowed before a connection is shut off.
159 #
160 TIMEOUT = 300
161 #
163 # Idle time allowed before a connection is shut off if you have not logged in yet.
164 #
165 login_timeout = 60
166 #
168 # If yes, resolves IP addresses to DNS names when logging.
169 #
170 RESOLVE_IP = no
171 #
173 # logfile for stdout messages
174 #
175 logfile = /var/log/dbmail/dbmail.log
176 #
178 # logfile for stderr messages
179 #
180 errorlog = /var/log/dbmail/dbmail.err
181 #
183 # directory for storing PID files
184 #
185 pid_directory = /var/run/dbmail
186 #
188 # directory for storing the daemon statefiles
189 #
190 state_directory = /var/run/dbmail
191 #
193 # directory for locating libraries (normally has a sane default compiled-in)
194 #
195 #library_directory = /usr/lib/dbmail
196 #
198 # log slow queries at level INFO after n seconds
199 #
200 query_time_info = 10
201 #
203 # log slow queries at level MESSAGE after n seconds
204 #
205 query_time_message = 20
206 #
208 # log slow queries at level WARNING after n seconds
209 #
210 query_time_warning = 30
211 [SMTP]
215 # In fact, there isn´t anything here by default.
216 [LMTP]
219 #
220 # Port to bind to.
221 #
222 PORT = 24
223 [POP]
225 #
226 # Port to bind to.
227 #
228 PORT = 110
229 #
231 # If yes, allows SMTP access from the host IP connecting by POP3.
232 # This requires addition configuration of your MTA
233 #
234 POP_BEFORE_SMTP = no
235 [IMAP]
237 #
239 # Port to bind to.
240 #
241 PORT = 143
242 #
244 # IMAP prefers a longer timeout than other services.
245 #
246 TIMEOUT = 4000
247 #
249 # If yes, allows SMTP access from the host IP connecting by IMAP.
250 # This requires addition configuration of your MTA
251 #
252 IMAP_BEFORE_SMTP = no
253 #
255 # during IDLE, how many seconds between checking the mailbox
256 # status (default: 30)
257 #
258 # idle_timeout = 30
259 #
261 # Provide a CAPABILITY to override the default
262 #
263 # capability = IMAP4 IMAP4rev1 AUTH=LOGIN ACL NAMESPACE CHILDREN SORT QUOTA THREAD=ORDEREDSUBJECT UNSELECT IDLE
264 [SIEVE]
268 #
269 # Port to bind to.
270 #
271 PORT = 2000
272 [LDAP]
274 PORT = 389
275 VERSION = 3
276 HOSTNAME = ldap
277 BASE_DN = ou=People,dc=mydomain,dc=com
278 #
280 # If your LDAP library supports ldap_initialize(), then you can use the
281 # alternative LDAP server DSN like following.
282 #
283 # URI = ldap://127.0.0.1:389
284 # URI = ldapi://%2fvar%2frun%2fopenldap%2fldapi/
285 #
287 # Leave blank for anonymous bind.
288 # example: cn=admin,dc=mydomain,dc=com
289 #
290 BIND_DN =
291 #
293 # Leave blank for anonymous bind.
294 #
295 BIND_PW =
296 SCOPE = SubTree
297 #
299 # AD users may want to set this to ´no´ to disable
300 # ldap referrals if you are seeing ´Operations errors´
301 # in your logs
302 #
303 REFERRALS = yes
304 USER_OBJECTCLASS = top,account,dbmailUser
306 FORW_OBJECTCLASS = top,account,dbmailForwardingAddress
307 CN_STRING = uid
308 FIELD_PASSWD = userPassword
309 FIELD_UID = uid
310 FIELD_NID = uidNumber
311 MIN_NID = 10000
312 MAX_NID = 15000
313 FIELD_CID = gidNumber
314 MIN_CID = 10000
315 MAX_CID = 15000
316 FIELD_MAIL = mail
317 FIELD_QUOTA = mailQuota
318 FIELD_FWDTARGET = mailForwardingAddress
319 [DELIVERY]
321 #
322 # Run Sieve scripts as messages are delivered.
323 #
324 SIEVE = yes
325 #
327 # Use ´user+mailbox@domain´ format to deliver to a mailbox.
328 #
329 SUBADDRESS = yes
330 #
332 # Turn on/off the Sieve Vacation extension.
333 #
334 SIEVE_VACATION = yes
335 #
337 # Turn on/off the Sieve Notify extension
338 #
339 SIEVE_NOTIFY = yes
340 #
342 # Turn on/off additional Sieve debugging.
343 #
344 SIEVE_DEBUG = no
345 #
347 # Use the auto_notify table to send email notifications.
348 #
349 AUTO_NOTIFY = no
350 #
352 # Use the auto_reply table to send away messages.
353 #
354 AUTO_REPLY = no
355 #
356 # Defaults to "NEW MAIL NOTIFICATION"
357 #
358 #AUTO_NOTIFY_SUBJECT =
359 #
361 # Defaults to POSTMASTER from the DBMAIL section.
362 #
363 #AUTO_NOTIFY_SENDER =
364 #
366 # If you set this to ´yes´ dbmail will check for duplicate
367 # messages in the relevant mailbox during delivery using
368 # the Message-ID header
369 #
370 suppress_duplicates = no
371 # end of configuration file
374
377 If you experience inexplicable problems with DBMail, please report the
378 issue to the DBMail Bug Tracker[1].
379
381 DBMail and its components are distributed under the terms of the GNU
382 General Public License. Copyrights are held variously by the authors
383 listed below.
384
386 DBMail is a collaborative effort among the core developers listed below
387 and the tremendous help of the testers, patchers and bug hunters listed
388 in the AUTHORS and THANKS files found in the DBMail source
389 distribution.
390 Eelco van Beek Aaron Stone Paul J Stevens
392 Roel Rozendaal Open Source Engineer NFG Net Facilities Group BV
393 Ilja Booij Palo Alto, CA USA http://www.nfg.nl
394 IC&S http://hydricacid.com
395 Koningsweg 4
396 3582 GE Utrecht
397 http://www.ic-s.nl
398
401 1. DBMail Bug Tracker
402 http://dbmail.org/index.php?page=bugs
403 10/07/2009 DBMAIL.CONF(5)