]> git.proxmox.com Git - pmg-docs.git/blame - pmg.conf.5-opts.adoc
gen-pmg.conf.5-opts.pl: add dnsbl_threshold to known parameters
[pmg-docs.git] / pmg.conf.5-opts.adoc
CommitLineData
f872534d
DM
1.Section 'admin'
2
9fda36b0
DM
3`advfilter`: `<boolean>` ('default =' `1`)::
4
5Use advanced filters for statistic.
6
f225b3b4
DM
7`avast`: `<boolean>` ('default =' `0`)::
8
9Use Avast Virus Scanner (/bin/scan). You need to buy and install 'Avast Core Security' before you can enable this feature.
10
11`clamav`: `<boolean>` ('default =' `1`)::
12
13Use ClamAV Virus Scanner. This is the default virus scanner and is enabled by default.
14
f872534d
DM
15`dailyreport`: `<boolean>` ('default =' `1`)::
16
17Send daily reports.
18
f872534d
DM
19`demo`: `<boolean>` ('default =' `0`)::
20
21Demo mode - do not start SMTP filter.
22
eff914dc
DM
23`email`: `<string>` ('default =' `admin@domain.tld`)::
24
25Administrator E-Mail address.
26
9fda36b0 27`http_proxy`: `http://.*` ::
f872534d 28
9fda36b0 29Specify external http proxy which is used for downloads (example: 'http://username:password@host:port/')
f872534d 30
a55e94a6
DM
31`statlifetime`: `<integer> (1 - N)` ('default =' `7`)::
32
33User Statistics Lifetime (days)
34
f872534d
DM
35.Section 'clamav'
36
37`archiveblockencrypted`: `<boolean>` ('default =' `0`)::
38
39Wether to block encrypted archives. Mark encrypted archives as viruses.
40
41`archivemaxfiles`: `<integer> (0 - N)` ('default =' `1000`)::
42
43Number of files to be scanned within an archive, a document, or any other kind of container. Warning: disabling this limit or setting it too high may result in severe damage to the system.
44
45`archivemaxrec`: `<integer> (1 - N)` ('default =' `5`)::
46
47Nested archives are scanned recursively, e.g. if a ZIP archive contains a TAR file, all files within it will also be scanned. This options specifies how deeply the process should be continued. Warning: setting this limit too high may result in severe damage to the system.
48
49`archivemaxsize`: `<integer> (1000000 - N)` ('default =' `25000000`)::
50
51Files larger than this limit won't be scanned.
52
53`dbmirror`: `<string>` ('default =' `database.clamav.net`)::
54
55ClamAV database mirror server.
56
f872534d
DM
57`maxcccount`: `<integer> (0 - N)` ('default =' `0`)::
58
59This option sets the lowest number of Credit Card or Social Security numbers found in a file to generate a detect.
60
61`maxscansize`: `<integer> (1000000 - N)` ('default =' `100000000`)::
62
63Sets the maximum amount of data to be scanned for each input file.
64
f245a28c
DM
65`safebrowsing`: `<boolean>` ('default =' `1`)::
66
67Enables support for Google Safe Browsing.
68
f872534d
DM
69.Section 'mail'
70
71`banner`: `<string>` ('default =' `ESMTP Proxmox`)::
72
73ESMTP banner.
74
75`conn_count_limit`: `<integer> (0 - N)` ('default =' `50`)::
76
77How many simultaneous connections any client is allowed to make to this service. To disable this feature, specify a limit of 0.
78
79`conn_rate_limit`: `<integer> (0 - N)` ('default =' `0`)::
80
81The maximal number of connection attempts any client is allowed to make to this service per minute. To disable this feature, specify a limit of 0.
82
f872534d
DM
83`dnsbl_sites`: `<string>` ::
84
85Optional list of DNS white/blacklist domains (see postscreen_dnsbl_sites parameter).
86
87`dwarning`: `<integer> (0 - N)` ('default =' `4`)::
88
89SMTP delay warning time (in hours).
90
4a46ced6 91`ext_port`: `<integer> (1 - 65535)` ('default =' `25`)::
eff914dc
DM
92
93SMTP port number for incoming mail (untrusted). This must be a different number than 'int_port'.
94
f872534d
DM
95`greylist`: `<boolean>` ('default =' `1`)::
96
97Use Greylisting.
98
99`helotests`: `<boolean>` ('default =' `0`)::
100
101Use SMTP HELO tests.
102
103`hide_received`: `<boolean>` ('default =' `0`)::
104
105Hide received header in outgoing mails.
106
4a46ced6 107`int_port`: `<integer> (1 - 65535)` ('default =' `26`)::
eff914dc
DM
108
109SMTP port number for outgoing mail (trusted).
110
f872534d
DM
111`max_filters`: `<integer> (3 - 40)` ('default =' `15`)::
112
113Maximum number of pmg-smtp-filter processes.
114
115`max_policy`: `<integer> (2 - 10)` ('default =' `5`)::
116
117Maximum number of pmgpolicy processes.
118
119`max_smtpd_in`: `<integer> (3 - 100)` ('default =' `99`)::
120
121Maximum number of SMTP daemon processes (in).
122
123`max_smtpd_out`: `<integer> (3 - 100)` ('default =' `99`)::
124
125Maximum number of SMTP daemon processes (out).
126
127`maxsize`: `<integer> (1024 - N)` ('default =' `10485760`)::
128
129Maximum email size. Larger mails are rejected.
130
131`message_rate_limit`: `<integer> (0 - N)` ('default =' `0`)::
132
133The maximal number of message delivery requests that any client is allowed to make to this service per minute.To disable this feature, specify a limit of 0.
134
135`rejectunknown`: `<boolean>` ('default =' `0`)::
136
137Reject unknown clients.
138
139`rejectunknownsender`: `<boolean>` ('default =' `0`)::
140
141Reject unknown senders.
142
143`relay`: `<string>` ::
144
145The default mail delivery transport (incoming mails).
146
147`relaynomx`: `<boolean>` ('default =' `0`)::
148
149Disable MX lookups for default relay.
150
151`relayport`: `<integer> (1 - 65535)` ('default =' `25`)::
152
153SMTP port number for relay host.
154
eff914dc
DM
155`smarthost`: `<string>` ::
156
157When set, all outgoing mails are deliverd to the specified smarthost.
158
f872534d
DM
159`spf`: `<boolean>` ('default =' `1`)::
160
161Use Sender Policy Framework.
162
163`tls`: `<boolean>` ('default =' `0`)::
164
eff914dc
DM
165Enable TLS.
166
167`tlsheader`: `<boolean>` ('default =' `0`)::
168
169Add TLS received header.
170
171`tlslog`: `<boolean>` ('default =' `0`)::
172
173Enable TLS Logging.
f872534d 174
eff914dc 175`verifyreceivers`: `<450 | 550>` ::
f872534d 176
eff914dc 177Enable receiver verification. The value spefifies the numerical reply code when the Postfix SMTP server rejects a recipient address.
f872534d
DM
178
179.Section 'spam'
180
181`bounce_score`: `<integer> (0 - 1000)` ('default =' `0`)::
182
183Additional score for bounce mails.
184
a18c67c0 185`clamav_heuristic_score`: `<integer> (0 - 1000)` ('default =' `3`)::
f872534d 186
a18c67c0 187Score for ClamaAV heuristics (Google Safe Browsing database, PhishingScanURLs, ...).
f872534d
DM
188
189`languages`: `(all|([a-z][a-z])+( ([a-z][a-z])+)*)` ('default =' `all`)::
190
191This option is used to specify which languages are considered OK for incoming mail.
192
a18c67c0 193`maxspamsize`: `<integer> (64 - N)` ('default =' `262144`)::
f872534d
DM
194
195Maximum size of spam messages in bytes.
196
197`rbl_checks`: `<boolean>` ('default =' `1`)::
198
199Enable real time blacklists (RBL) checks.
200
201`use_awl`: `<boolean>` ('default =' `1`)::
202
203Use the Auto-Whitelist plugin.
204
205`use_bayes`: `<boolean>` ('default =' `1`)::
206
207Whether to use the naive-Bayesian-style classifier.
208
f872534d
DM
209`use_razor`: `<boolean>` ('default =' `1`)::
210
211Whether to use Razor2, if it is available.
212
213`wl_bounce_relays`: `<string>` ::
214
215Whitelist legitimate bounce relays.
216
f245a28c
DM
217.Section 'spamquar'
218
219`allowhrefs`: `<boolean>` ('default =' `1`)::
220
221Allow to view hyperlinks.
222
223`authmode`: `<ldap | ldapticket | ticket>` ('default =' `ticket`)::
224
225Authentication mode to access the quarantine interface. Mode 'ticket' allows login using tickets sent with the daily spam report. Mode 'ldap' requires to login using an LDAP account. Finally, mode 'ldapticket' allows both ways.
226
f245a28c
DM
227`hostname`: `<string>` ::
228
b81b1f95 229Quarantine Host. Useful if you run a Cluster and want users to connect to a specific host.
f245a28c
DM
230
231`lifetime`: `<integer> (1 - N)` ('default =' `7`)::
232
233Quarantine life time (days)
234
235`mailfrom`: `<string>` ::
236
237Text for 'From' header in daily spam report mails.
238
b81b1f95
DM
239`port`: `<integer> (1 - 65535)` ('default =' `8006`)::
240
241Quarantine Port. Useful if you have a reverse proxy or port forwarding for the webinterface. Only used for the generated Spam report.
242
243`protocol`: `<http | https>` ('default =' `https`)::
244
245Quarantine Webinterface Protocol. Useful if you have a reverse proxy for the webinterface. Only used for the generated Spam report.
246
d7cd791b 247`reportstyle`: `<custom | none | short | verbose>` ('default =' `verbose`)::
f245a28c
DM
248
249Spam report style.
250
251`viewimages`: `<boolean>` ('default =' `1`)::
252
253Allow to view images.
254
255.Section 'virusquar'
256
257`allowhrefs`: `<boolean>` ('default =' `1`)::
258
259Allow to view hyperlinks.
260
f245a28c
DM
261`lifetime`: `<integer> (1 - N)` ('default =' `7`)::
262
263Quarantine life time (days)
264
265`viewimages`: `<boolean>` ('default =' `1`)::
266
267Allow to view images.
268