1SMTPD(8)                    System Manager's Manual                   SMTPD(8)
2
3
4

NAME

6       smtpd - Postfix SMTP server
7

SYNOPSIS

9       smtpd [generic Postfix daemon options]
10
11       sendmail -bs
12

DESCRIPTION

14       The  SMTP  server accepts network connection requests and performs zero
15       or more SMTP transactions per connection.   Each  received  message  is
16       piped  through  the  cleanup(8) daemon, and is placed into the incoming
17       queue as one single queue file.  For this mode of operation,  the  pro‐
18       gram expects to be run from the master(8) process manager.
19
20       Alternatively,  the SMTP server be can run in stand-alone mode; this is
21       traditionally obtained with "sendmail -bs".  When the SMTP server  runs
22       stand-alone  with  non  $mail_owner  privileges,  it receives mail even
23       while the mail system is not running, deposits messages  directly  into
24       the  maildrop queue, and disables the SMTP server's access policies. As
25       of Postfix version 2.3, the SMTP server refuses to  receive  mail  from
26       the network when it runs with non $mail_owner privileges.
27
28       The  SMTP  server  implements  a variety of policies for connection re‐
29       quests, and for parameters given to HELO, ETRN,  MAIL  FROM,  VRFY  and
30       RCPT TO commands. They are detailed below and in the main.cf configura‐
31       tion file.
32

SECURITY

34       The SMTP server is moderately  security-sensitive.  It  talks  to  SMTP
35       clients  and  to DNS servers on the network. The SMTP server can be run
36       chrooted at fixed low privilege.
37

STANDARDS

39       RFC 821 (SMTP protocol)
40       RFC 1123 (Host requirements)
41       RFC 1652 (8bit-MIME transport)
42       RFC 1869 (SMTP service extensions)
43       RFC 1870 (Message size declaration)
44       RFC 1985 (ETRN command)
45       RFC 2034 (SMTP enhanced status codes)
46       RFC 2554 (AUTH command)
47       RFC 2821 (SMTP protocol)
48       RFC 2920 (SMTP pipelining)
49       RFC 3030 (CHUNKING without BINARYMIME)
50       RFC 3207 (STARTTLS command)
51       RFC 3461 (SMTP DSN extension)
52       RFC 3463 (Enhanced status codes)
53       RFC 3848 (ESMTP transmission types)
54       RFC 4409 (Message submission)
55       RFC 4954 (AUTH command)
56       RFC 5321 (SMTP protocol)
57       RFC 6531 (Internationalized SMTP)
58       RFC 6533 (Internationalized Delivery Status Notifications)
59       RFC 7505 ("Null MX" No Service Resource Record)
60

DIAGNOSTICS

62       Problems and transactions are logged to syslogd(8) or postlogd(8).
63
64       Depending on the setting of the notify_classes parameter, the  postmas‐
65       ter  is  notified of bounces, protocol problems, policy violations, and
66       of other trouble.
67

CONFIGURATION PARAMETERS

69       Changes to main.cf are picked up automatically, as  smtpd(8)  processes
70       run for only a limited amount of time. Use the command "postfix reload"
71       to speed up a change.
72
73       The text below provides only a parameter summary. See  postconf(5)  for
74       more details including examples.
75

COMPATIBILITY CONTROLS

77       The  following  parameters  work  around implementation errors in other
78       software, and/or allow you to override standards in  order  to  prevent
79       undesirable use.
80
81       broken_sasl_auth_clients (no)
82              Enable  interoperability with remote SMTP clients that implement
83              an obsolete version of the AUTH command (RFC 4954).
84
85       disable_vrfy_command (no)
86              Disable the SMTP VRFY command.
87
88       smtpd_noop_commands (empty)
89              List of commands that the Postfix SMTP server  replies  to  with
90              "250  Ok",  without doing any syntax checks and without changing
91              state.
92
93       strict_rfc821_envelopes (no)
94              Require that addresses received in SMTP MAIL FROM  and  RCPT  TO
95              commands  are  enclosed with <>, and that those addresses do not
96              contain RFC 822 style comments or phrases.
97
98       Available in Postfix version 2.1 and later:
99
100       smtpd_reject_unlisted_sender (no)
101              Request that the Postfix SMTP server rejects mail  from  unknown
102              sender  addresses,  even when no explicit reject_unlisted_sender
103              access restriction is specified.
104
105       smtpd_sasl_exceptions_networks (empty)
106              What remote SMTP clients the Postfix SMTP server will not  offer
107              AUTH support to.
108
109       Available in Postfix version 2.2 and later:
110
111       smtpd_discard_ehlo_keyword_address_maps (empty)
112              Lookup  tables,  indexed by the remote SMTP client address, with
113              case insensitive lists of EHLO keywords  (pipelining,  starttls,
114              auth,  etc.)  that  the Postfix SMTP server will not send in the
115              EHLO response to a remote SMTP client.
116
117       smtpd_discard_ehlo_keywords (empty)
118              A case insensitive list of EHLO keywords (pipelining,  starttls,
119              auth,  etc.)  that  the Postfix SMTP server will not send in the
120              EHLO response to a remote SMTP client.
121
122       smtpd_delay_open_until_valid_rcpt (yes)
123              Postpone the start of an SMTP mail  transaction  until  a  valid
124              RCPT TO command is received.
125
126       Available in Postfix version 2.3 and later:
127
128       smtpd_tls_always_issue_session_ids (yes)
129              Force  the  Postfix  SMTP server to issue a TLS session id, even
130              when  TLS  session  caching  is   turned   off   (smtpd_tls_ses‐
131              sion_cache_database is empty).
132
133       Available in Postfix version 2.6 and later:
134
135       tcp_windowsize (0)
136              An  optional  workaround for routers that break TCP window scal‐
137              ing.
138
139       Available in Postfix version 2.7 and later:
140
141       smtpd_command_filter (empty)
142              A mechanism to transform commands from remote SMTP clients.
143
144       Available in Postfix version 2.9 - 3.6:
145
146       smtpd_per_record_deadline (normal: no, overload: yes)
147              Change  the  behavior  of  the  smtpd_timeout  and  smtpd_start‐
148              tls_timeout  time  limits,  from  a time limit per read or write
149              system call, to a time limit  to  send  or  receive  a  complete
150              record  (an  SMTP command line, SMTP response line, SMTP message
151              content line, or TLS protocol message).
152
153       Available in Postfix version 3.0 and later:
154
155       smtpd_dns_reply_filter (empty)
156              Optional filter for Postfix SMTP server DNS lookup results.
157
158       Available in Postfix 3.5 and later:
159
160       info_log_address_format (external)
161              The email address form that will be used  in  non-debug  logging
162              (info, warning, etc.).
163
164       Available in Postfix version 3.6 and later:
165
166       smtpd_relay_before_recipient_restrictions (see 'postconf -d' output)
167              Evaluate   smtpd_relay_restrictions  before  smtpd_recipient_re‐
168              strictions.
169
170       known_tcp_ports  (lmtp=24,  smtp=25,   smtps=submissions=465,   submis‐
171       sion=587)
172              Optional  setting  that  avoids lookups in the services(5) data‐
173              base.
174
175       Available in Postfix version 3.7 and later:
176
177       smtpd_per_request_deadline (normal: no, overload: yes)
178              Change  the  behavior  of  the  smtpd_timeout  and  smtpd_start‐
179              tls_timeout  time limits, from a time limit per plaintext or TLS
180              read or write call, to a combined time  limit  for  receiving  a
181              complete SMTP request and for sending a complete SMTP response.
182
183       smtpd_min_data_rate (500)
184              The  minimum  plaintext  data  transfer rate in bytes/second for
185              DATA  and  BDAT  requests,  when  deadlines  are  enabled   with
186              smtpd_per_request_deadline.
187

ADDRESS REWRITING CONTROLS

189       See  the ADDRESS_REWRITING_README document for a detailed discussion of
190       Postfix address rewriting.
191
192       receive_override_options (empty)
193              Enable or disable recipient validation, built-in content filter‐
194              ing, or address mapping.
195
196       Available in Postfix version 2.2 and later:
197
198       local_header_rewrite_clients (permit_inet_interfaces)
199              Rewrite  or  add message headers in mail from these clients, up‐
200              dating incomplete addresses with the domain name in $myorigin or
201              $mydomain, and adding missing headers.
202

BEFORE-SMTPD PROXY AGENT

204       Available in Postfix version 2.10 and later:
205
206       smtpd_upstream_proxy_protocol (empty)
207              The  name of the proxy protocol used by an optional before-smtpd
208              proxy agent.
209
210       smtpd_upstream_proxy_timeout (5s)
211              The time  limit  for  the  proxy  protocol  specified  with  the
212              smtpd_upstream_proxy_protocol parameter.
213

AFTER QUEUE EXTERNAL CONTENT INSPECTION CONTROLS

215       As of version 1.0, Postfix can be configured to send new mail to an ex‐
216       ternal content filter AFTER the mail is queued. This content filter  is
217       expected  to inject mail back into a (Postfix or other) MTA for further
218       delivery. See the FILTER_README document for details.
219
220       content_filter (empty)
221              After the message is queued, send  the  entire  message  to  the
222              specified transport:destination.
223

BEFORE QUEUE EXTERNAL CONTENT INSPECTION CONTROLS

225       As  of  version  2.1, the Postfix SMTP server can be configured to send
226       incoming mail to a real-time SMTP-based content filter BEFORE  mail  is
227       queued.  This content filter is expected to inject mail back into Post‐
228       fix.  See the SMTPD_PROXY_README document for details on how to config‐
229       ure and operate this feature.
230
231       smtpd_proxy_filter (empty)
232              The hostname and TCP port of the mail filtering proxy server.
233
234       smtpd_proxy_ehlo ($myhostname)
235              How  the  Postfix SMTP server announces itself to the proxy fil‐
236              ter.
237
238       smtpd_proxy_options (empty)
239              List of options that control how the Postfix SMTP server  commu‐
240              nicates with a before-queue content filter.
241
242       smtpd_proxy_timeout (100s)
243              The  time limit for connecting to a proxy filter and for sending
244              or receiving information.
245

BEFORE QUEUE MILTER CONTROLS

247       As of version 2.3, Postfix supports the Sendmail version 8 Milter (mail
248       filter)  protocol.  These content filters run outside Postfix. They can
249       inspect the SMTP command stream and the message content,  and  can  re‐
250       quest  modifications  before  mail  is queued. For details see the MIL‐
251       TER_README document.
252
253       smtpd_milters (empty)
254              A list of Milter (mail filter) applications for  new  mail  that
255              arrives via the Postfix smtpd(8) server.
256
257       milter_protocol (6)
258              The  mail  filter  protocol version and optional protocol exten‐
259              sions for communication with  a  Milter  application;  prior  to
260              Postfix 2.6 the default protocol is 2.
261
262       milter_default_action (tempfail)
263              The  default  action when a Milter (mail filter) response is un‐
264              available (for example,  bad  Postfix  configuration  or  Milter
265              failure).
266
267       milter_macro_daemon_name ($myhostname)
268              The  {daemon_name} macro value for Milter (mail filter) applica‐
269              tions.
270
271       milter_macro_v ($mail_name $mail_version)
272              The {v} macro value for Milter (mail filter) applications.
273
274       milter_connect_timeout (30s)
275              The time limit for connecting to a Milter (mail filter) applica‐
276              tion, and for negotiating protocol options.
277
278       milter_command_timeout (30s)
279              The  time  limit  for  sending an SMTP command to a Milter (mail
280              filter) application, and for receiving the response.
281
282       milter_content_timeout (300s)
283              The time limit for sending message content  to  a  Milter  (mail
284              filter) application, and for receiving the response.
285
286       milter_connect_macros (see 'postconf -d' output)
287              The  macros  that  are sent to Milter (mail filter) applications
288              after completion of an SMTP connection.
289
290       milter_helo_macros (see 'postconf -d' output)
291              The macros that are sent to Milter  (mail  filter)  applications
292              after the SMTP HELO or EHLO command.
293
294       milter_mail_macros (see 'postconf -d' output)
295              The  macros  that  are sent to Milter (mail filter) applications
296              after the SMTP MAIL FROM command.
297
298       milter_rcpt_macros (see 'postconf -d' output)
299              The macros that are sent to Milter  (mail  filter)  applications
300              after the SMTP RCPT TO command.
301
302       milter_data_macros (see 'postconf -d' output)
303              The  macros  that  are  sent to version 4 or higher Milter (mail
304              filter) applications after the SMTP DATA command.
305
306       milter_unknown_command_macros (see 'postconf -d' output)
307              The macros that are sent to version 3  or  higher  Milter  (mail
308              filter) applications after an unknown SMTP command.
309
310       milter_end_of_header_macros (see 'postconf -d' output)
311              The  macros  that  are sent to Milter (mail filter) applications
312              after the end of the message header.
313
314       milter_end_of_data_macros (see 'postconf -d' output)
315              The macros that are sent to Milter  (mail  filter)  applications
316              after the message end-of-data.
317
318       Available in Postfix version 3.1 and later:
319
320       milter_macro_defaults (empty)
321              Optional  list  of  name=value pairs that specify default values
322              for arbitrary macros that Postfix may send  to  Milter  applica‐
323              tions.
324
325       Available in Postfix version 3.2 and later:
326
327       smtpd_milter_maps (empty)
328              Lookup tables with Milter settings per remote SMTP client IP ad‐
329              dress.
330

GENERAL CONTENT INSPECTION CONTROLS

332       The following parameters are applicable for both built-in and  external
333       content filters.
334
335       Available in Postfix version 2.1 and later:
336
337       receive_override_options (empty)
338              Enable or disable recipient validation, built-in content filter‐
339              ing, or address mapping.
340

EXTERNAL CONTENT INSPECTION CONTROLS

342       The following parameters are applicable for both before-queue  and  af‐
343       ter-queue content filtering.
344
345       Available in Postfix version 2.1 and later:
346
347       smtpd_authorized_xforward_hosts (empty)
348              What  remote  SMTP  clients are allowed to use the XFORWARD fea‐
349              ture.
350

SASL AUTHENTICATION CONTROLS

352       Postfix SASL support (RFC 4954) can be used to authenticate remote SMTP
353       clients  to  the  Postfix  SMTP server, and to authenticate the Postfix
354       SMTP client to a remote SMTP server.  See the SASL_README document  for
355       details.
356
357       broken_sasl_auth_clients (no)
358              Enable  interoperability with remote SMTP clients that implement
359              an obsolete version of the AUTH command (RFC 4954).
360
361       smtpd_sasl_auth_enable (no)
362              Enable SASL authentication in the Postfix SMTP server.
363
364       smtpd_sasl_local_domain (empty)
365              The name of the Postfix SMTP server's local SASL  authentication
366              realm.
367
368       smtpd_sasl_security_options (noanonymous)
369              Postfix SMTP server SASL security options; as of Postfix 2.3 the
370              list of available features depends on the SASL server  implemen‐
371              tation that is selected with smtpd_sasl_type.
372
373       smtpd_sender_login_maps (empty)
374              Optional  lookup  table  with  the SASL login names that own the
375              sender (MAIL FROM) addresses.
376
377       Available in Postfix version 2.1 and later:
378
379       smtpd_sasl_exceptions_networks (empty)
380              What remote SMTP clients the Postfix SMTP server will not  offer
381              AUTH support to.
382
383       Available in Postfix version 2.1 and 2.2:
384
385       smtpd_sasl_application_name (smtpd)
386              The  application name that the Postfix SMTP server uses for SASL
387              server initialization.
388
389       Available in Postfix version 2.3 and later:
390
391       smtpd_sasl_authenticated_header (no)
392              Report the SASL authenticated user name in the smtpd(8) Received
393              message header.
394
395       smtpd_sasl_path (smtpd)
396              Implementation-specific information that the Postfix SMTP server
397              passes through to the SASL plug-in implementation  that  is  se‐
398              lected with smtpd_sasl_type.
399
400       smtpd_sasl_type (cyrus)
401              The  SASL  plug-in  type that the Postfix SMTP server should use
402              for authentication.
403
404       Available in Postfix version 2.5 and later:
405
406       cyrus_sasl_config_path (empty)
407              Search path for Cyrus SASL application configuration files, cur‐
408              rently used only to locate the $smtpd_sasl_path.conf file.
409
410       Available in Postfix version 2.11 and later:
411
412       smtpd_sasl_service (smtp)
413              The  service name that is passed to the SASL plug-in that is se‐
414              lected with smtpd_sasl_type and smtpd_sasl_path.
415
416       Available in Postfix version 3.4 and later:
417
418       smtpd_sasl_response_limit (12288)
419              The maximum length of a SASL client's response to a server chal‐
420              lenge.
421
422       Available in Postfix 3.6 and later:
423
424       smtpd_sasl_mechanism_filter (!external, static:rest)
425              If  non-empty,  a  filter  for the SASL mechanism names that the
426              Postfix SMTP server will announce in the EHLO response.
427

STARTTLS SUPPORT CONTROLS

429       Detailed information about STARTTLS configuration may be found  in  the
430       TLS_README document.
431
432       smtpd_tls_security_level (empty)
433              The  SMTP TLS security level for the Postfix SMTP server; when a
434              non-empty value is specified, this overrides the obsolete param‐
435              eters smtpd_use_tls and smtpd_enforce_tls.
436
437       smtpd_sasl_tls_security_options ($smtpd_sasl_security_options)
438              The  SASL  authentication security options that the Postfix SMTP
439              server uses for TLS encrypted SMTP sessions.
440
441       smtpd_starttls_timeout (see 'postconf -d' output)
442              The time limit for Postfix SMTP server write and read operations
443              during TLS startup and shutdown handshake procedures.
444
445       smtpd_tls_CAfile (empty)
446              A  file  containing  (PEM  format)  CA  certificates of root CAs
447              trusted to sign either remote SMTP client certificates or inter‐
448              mediate CA certificates.
449
450       smtpd_tls_CApath (empty)
451              A  directory containing (PEM format) CA certificates of root CAs
452              trusted to sign either remote SMTP client certificates or inter‐
453              mediate CA certificates.
454
455       smtpd_tls_always_issue_session_ids (yes)
456              Force  the  Postfix  SMTP server to issue a TLS session id, even
457              when  TLS  session  caching  is   turned   off   (smtpd_tls_ses‐
458              sion_cache_database is empty).
459
460       smtpd_tls_ask_ccert (no)
461              Ask a remote SMTP client for a client certificate.
462
463       smtpd_tls_auth_only (no)
464              When  TLS  encryption is optional in the Postfix SMTP server, do
465              not announce or accept SASL authentication over unencrypted con‐
466              nections.
467
468       smtpd_tls_ccert_verifydepth (9)
469              The verification depth for remote SMTP client certificates.
470
471       smtpd_tls_cert_file (empty)
472              File with the Postfix SMTP server RSA certificate in PEM format.
473
474       smtpd_tls_exclude_ciphers (empty)
475              List  of ciphers or cipher types to exclude from the SMTP server
476              cipher list at all TLS security levels.
477
478       smtpd_tls_dcert_file (empty)
479              File with the Postfix SMTP server DSA certificate in PEM format.
480
481       smtpd_tls_dh1024_param_file (empty)
482              File with DH parameters that the Postfix SMTP server should  use
483              with non-export EDH ciphers.
484
485       smtpd_tls_dh512_param_file (empty)
486              File  with DH parameters that the Postfix SMTP server should use
487              with export-grade EDH ciphers.
488
489       smtpd_tls_dkey_file ($smtpd_tls_dcert_file)
490              File with the Postfix SMTP server DSA private key in PEM format.
491
492       smtpd_tls_key_file ($smtpd_tls_cert_file)
493              File with the Postfix SMTP server RSA private key in PEM format.
494
495       smtpd_tls_loglevel (0)
496              Enable additional Postfix SMTP server logging of TLS activity.
497
498       smtpd_tls_mandatory_ciphers (medium)
499              The minimum TLS cipher grade that the Postfix SMTP  server  will
500              use with mandatory TLS encryption.
501
502       smtpd_tls_mandatory_exclude_ciphers (empty)
503              Additional  list  of ciphers or cipher types to exclude from the
504              Postfix SMTP server cipher list at mandatory TLS  security  lev‐
505              els.
506
507       smtpd_tls_mandatory_protocols (see 'postconf -d' output)
508              TLS protocols accepted by the Postfix SMTP server with mandatory
509              TLS encryption.
510
511       smtpd_tls_received_header (no)
512              Request that the Postfix SMTP server produces Received:  message
513              headers  that  include information about the protocol and cipher
514              used, as well as the remote SMTP client  CommonName  and  client
515              certificate issuer CommonName.
516
517       smtpd_tls_req_ccert (no)
518              With  mandatory  TLS  encryption,  require a trusted remote SMTP
519              client certificate in order to allow TLS connections to proceed.
520
521       smtpd_tls_wrappermode (no)
522              Run the Postfix SMTP server in TLS "wrapper"  mode,  instead  of
523              using the STARTTLS command.
524
525       tls_daemon_random_bytes (32)
526              The  number  of  pseudo-random bytes that an smtp(8) or smtpd(8)
527              process requests from the tlsmgr(8) server in order to seed  its
528              internal pseudo random number generator (PRNG).
529
530       tls_high_cipherlist (see 'postconf -d' output)
531              The OpenSSL cipherlist for "high" grade ciphers.
532
533       tls_medium_cipherlist (see 'postconf -d' output)
534              The OpenSSL cipherlist for "medium" or higher grade ciphers.
535
536       tls_null_cipherlist (eNULL:!aNULL)
537              The OpenSSL cipherlist for "NULL" grade ciphers that provide au‐
538              thentication without encryption.
539
540       Available in Postfix version 2.3..3.7:
541
542       tls_low_cipherlist (see 'postconf -d' output)
543              The OpenSSL cipherlist for "low" or higher grade ciphers.
544
545       tls_export_cipherlist (see 'postconf -d' output)
546              The OpenSSL cipherlist for "export" or higher grade ciphers.
547
548       Available in Postfix version 2.5 and later:
549
550       smtpd_tls_fingerprint_digest (see 'postconf -d' output)
551              The  message  digest  algorithm   to   construct   remote   SMTP
552              client-certificate   fingerprints  or  public  key  fingerprints
553              (Postfix  2.9  and  later)  for  check_ccert_access   and   per‐
554              mit_tls_clientcerts.
555
556       Available in Postfix version 2.6 and later:
557
558       smtpd_tls_protocols (see postconf -d output)
559              TLS  protocols  accepted  by the Postfix SMTP server with oppor‐
560              tunistic TLS encryption.
561
562       smtpd_tls_ciphers (medium)
563              The minimum TLS cipher grade that the Postfix SMTP  server  will
564              use with opportunistic TLS encryption.
565
566       smtpd_tls_eccert_file (empty)
567              File  with the Postfix SMTP server ECDSA certificate in PEM for‐
568              mat.
569
570       smtpd_tls_eckey_file ($smtpd_tls_eccert_file)
571              File with the Postfix SMTP server ECDSA private key in PEM  for‐
572              mat.
573
574       smtpd_tls_eecdh_grade (see 'postconf -d' output)
575              The  Postfix  SMTP  server  security  grade for ephemeral ellip‐
576              tic-curve Diffie-Hellman (EECDH) key exchange.
577
578       tls_eecdh_strong_curve (prime256v1)
579              The elliptic curve used by the Postfix SMTP server for  sensibly
580              strong ephemeral ECDH key exchange.
581
582       tls_eecdh_ultra_curve (secp384r1)
583              The elliptic curve used by the Postfix SMTP server for maximally
584              strong ephemeral ECDH key exchange.
585
586       Available in Postfix version 2.8 and later:
587
588       tls_preempt_cipherlist (no)
589              With SSLv3 and later, use the Postfix SMTP server's cipher pref‐
590              erence  order  instead  of the remote client's cipher preference
591              order.
592
593       tls_disable_workarounds (see 'postconf -d' output)
594              List or bit-mask of OpenSSL bug work-arounds to disable.
595
596       Available in Postfix version 2.11 and later:
597
598       tlsmgr_service_name (tlsmgr)
599              The name of the tlsmgr(8) service entry in master.cf.
600
601       Available in Postfix version 3.0 and later:
602
603       tls_session_ticket_cipher (Postfix >= 3.0: aes-256-cbc, Postfix <  3.0:
604       aes-128-cbc)
605              Algorithm used to encrypt RFC5077 TLS session tickets.
606
607       Available in Postfix version 3.2 and later:
608
609       tls_eecdh_auto_curves (see 'postconf -d' output)
610              The prioritized list of elliptic curves supported by the Postfix
611              SMTP client and server.
612
613       Available in Postfix version 3.4 and later:
614
615       smtpd_tls_chain_files (empty)
616              List of one or more PEM files, each holding one or more  private
617              keys directly followed by a corresponding certificate chain.
618
619       tls_server_sni_maps (empty)
620              Optional  lookup tables that map names received from remote SMTP
621              clients via the TLS Server Name Indication  (SNI)  extension  to
622              the appropriate keys and certificate chains.
623
624       Available in Postfix 3.5, 3.4.6, 3.3.5, 3.2.10, 3.1.13 and later:
625
626       tls_fast_shutdown_enable (yes)
627              A  workaround  for implementations that hang Postfix while shut‐
628              ting down a TLS session, until Postfix times out.
629
630       Available in Postfix version 3.8 and later:
631
632       tls_ffdhe_auto_groups (see 'postconf -d' output)
633              The prioritized list of  finite-field  Diffie-Hellman  ephemeral
634              (FFDHE) key exchange groups supported by the Postfix SMTP client
635              and server.
636
637       Available in Postfix 3.9, 3.8.1, 3.7.6, 3.6.10, 3.5.20 and later:
638
639       tls_config_file (default)
640              Optional configuration file with baseline OpenSSL settings.
641
642       tls_config_name (empty)
643              The application name passed by Postfix to OpenSSL  library  ini‐
644              tialization functions.
645

OBSOLETE STARTTLS CONTROLS

647       The  following  configuration  parameters  exist for compatibility with
648       Postfix versions before 2.3. Support for these will be removed in a fu‐
649       ture release.
650
651       smtpd_use_tls (no)
652              Opportunistic  TLS:  announce  STARTTLS  support  to remote SMTP
653              clients, but do not require that clients use TLS encryption.
654
655       smtpd_enforce_tls (no)
656              Mandatory TLS: announce STARTTLS support to remote SMTP clients,
657              and require that clients use TLS encryption.
658
659       smtpd_tls_cipherlist (empty)
660              Obsolete  Postfix  < 2.3 control for the Postfix SMTP server TLS
661              cipher list.
662

SMTPUTF8 CONTROLS

664       Preliminary SMTPUTF8 support is introduced with Postfix 3.0.
665
666       smtputf8_enable (yes)
667              Enable preliminary SMTPUTF8 support for the protocols  described
668              in RFC 6531, RFC 6532, and RFC 6533.
669
670       strict_smtputf8 (no)
671              Enable stricter enforcement of the SMTPUTF8 protocol.
672
673       smtputf8_autodetect_classes (sendmail, verify)
674              Detect  that  a message requires SMTPUTF8 support for the speci‐
675              fied mail origin classes.
676
677       Available in Postfix version 3.2 and later:
678
679       enable_idna2003_compatibility (no)
680              Enable  'transitional'  compatibility   between   IDNA2003   and
681              IDNA2008,  when  converting UTF-8 domain names to/from the ASCII
682              form that is used for DNS lookups.
683

VERP SUPPORT CONTROLS

685       With VERP style delivery, each recipient of a message receives  a  cus‐
686       tomized  copy of the message with his/her own recipient address encoded
687       in the envelope sender address.  The VERP_README file describes config‐
688       uration  and operation details of Postfix support for variable envelope
689       return path addresses.  VERP style delivery is requested with the  SMTP
690       XVERP  command  or  with  the  "sendmail -V" command-line option and is
691       available in Postfix version 1.1 and later.
692
693       default_verp_delimiters (+=)
694              The two default VERP delimiter characters.
695
696       verp_delimiter_filter (-=+)
697              The characters Postfix accepts as VERP delimiter  characters  on
698              the Postfix sendmail(1) command line and in SMTP commands.
699
700       Available in Postfix version 1.1 and 2.0:
701
702       authorized_verp_clients ($mynetworks)
703              What  remote  SMTP clients are allowed to specify the XVERP com‐
704              mand.
705
706       Available in Postfix version 2.1 and later:
707
708       smtpd_authorized_verp_clients ($authorized_verp_clients)
709              What remote SMTP clients are allowed to specify the  XVERP  com‐
710              mand.
711

TROUBLE SHOOTING CONTROLS

713       The  DEBUG_README  document describes how to debug parts of the Postfix
714       mail system. The methods vary from making the software log a lot of de‐
715       tail,  to  running some daemon processes under control of a call tracer
716       or debugger.
717
718       debug_peer_level (2)
719              The increment in verbose logging level when a  nexthop  destina‐
720              tion,  remote client or server name or network address matches a
721              pattern given with the debug_peer_list parameter.
722
723       debug_peer_list (empty)
724              Optional list of nexthop destination, remote  client  or  server
725              name  or  network  address  patterns that, if matched, cause the
726              verbose logging level to increase by  the  amount  specified  in
727              $debug_peer_level.
728
729       error_notice_recipient (postmaster)
730              The  recipient  of  postmaster notifications about mail delivery
731              problems that are caused by policy, resource, software or proto‐
732              col errors.
733
734       internal_mail_filter_classes (empty)
735              What  categories  of  Postfix-generated  mail are subject to be‐
736              fore-queue    content    inspection    by     non_smtpd_milters,
737              header_checks and body_checks.
738
739       notify_classes (resource, software)
740              The list of error classes that are reported to the postmaster.
741
742       smtpd_reject_footer (empty)
743              Optional  information  that  is appended after each Postfix SMTP
744              server 4XX or 5XX response.
745
746       soft_bounce (no)
747              Safety net to keep mail queued that would otherwise be  returned
748              to the sender.
749
750       Available in Postfix version 2.1 and later:
751
752       smtpd_authorized_xclient_hosts (empty)
753              What remote SMTP clients are allowed to use the XCLIENT feature.
754
755       Available in Postfix version 2.10 and later:
756
757       smtpd_log_access_permit_actions (empty)
758              Enable  logging of the named "permit" actions in SMTP server ac‐
759              cess lists (by default, the SMTP server  logs  "reject"  actions
760              but not "permit" actions).
761

KNOWN VERSUS UNKNOWN RECIPIENT CONTROLS

763       As of Postfix version 2.0, the SMTP server rejects mail for unknown re‐
764       cipients. This prevents the mail queue from clogging up with undeliver‐
765       able MAILER-DAEMON messages. Additional information on this topic is in
766       the LOCAL_RECIPIENT_README and ADDRESS_CLASS_README documents.
767
768       show_user_unknown_table_name (yes)
769              Display the name of the recipient table in  the  "User  unknown"
770              responses.
771
772       canonical_maps (empty)
773              Optional  address  mapping lookup tables for message headers and
774              envelopes.
775
776       recipient_canonical_maps (empty)
777              Optional address mapping lookup tables for envelope  and  header
778              recipient addresses.
779
780       sender_canonical_maps (empty)
781              Optional  address  mapping lookup tables for envelope and header
782              sender addresses.
783
784       Parameters concerning known/unknown local recipients:
785
786       mydestination ($myhostname, localhost.$mydomain, localhost)
787              The list of domains that are delivered via the  $local_transport
788              mail delivery transport.
789
790       inet_interfaces (all)
791              The  local network interface addresses that this mail system re‐
792              ceives mail on.
793
794       proxy_interfaces (empty)
795              The remote network interface addresses that this mail system re‐
796              ceives  mail on by way of a proxy or network address translation
797              unit.
798
799       inet_protocols (see 'postconf -d output')
800              The Internet protocols Postfix will attempt to use  when  making
801              or accepting connections.
802
803       local_recipient_maps (proxy:unix:passwd.byname $alias_maps)
804              Lookup tables with all names or addresses of local recipients: a
805              recipient address is local when its domain  matches  $mydestina‐
806              tion, $inet_interfaces or $proxy_interfaces.
807
808       unknown_local_recipient_reject_code (550)
809              The numerical Postfix SMTP server response code when a recipient
810              address is local, and $local_recipient_maps specifies a list  of
811              lookup tables that does not match the recipient.
812
813       Parameters concerning known/unknown recipients of relay destinations:
814
815       relay_domains (Postfix >= 3.0: empty, Postfix < 3.0: $mydestination)
816              What  destination  domains  (and subdomains thereof) this system
817              will relay mail to.
818
819       relay_recipient_maps (empty)
820              Optional lookup tables with all valid addresses in  the  domains
821              that match $relay_domains.
822
823       unknown_relay_recipient_reject_code (550)
824              The  numerical  Postfix  SMTP server reply code when a recipient
825              address matches $relay_domains, and relay_recipient_maps  speci‐
826              fies  a  list of lookup tables that does not match the recipient
827              address.
828
829       Parameters concerning known/unknown recipients  in  virtual  alias  do‐
830       mains:
831
832       virtual_alias_domains ($virtual_alias_maps)
833              Postfix  is the final destination for the specified list of vir‐
834              tual alias domains, that is, domains for which all addresses are
835              aliased to addresses in other local or remote domains.
836
837       virtual_alias_maps ($virtual_maps)
838              Optional lookup tables that alias specific mail addresses or do‐
839              mains to other local or remote addresses.
840
841       unknown_virtual_alias_reject_code (550)
842              The Postfix SMTP server reply  code  when  a  recipient  address
843              matches  $virtual_alias_domains,  and $virtual_alias_maps speci‐
844              fies a list of lookup tables that does not match  the  recipient
845              address.
846
847       Parameters  concerning  known/unknown recipients in virtual mailbox do‐
848       mains:
849
850       virtual_mailbox_domains ($virtual_mailbox_maps)
851              Postfix is the final destination for the specified list  of  do‐
852              mains;  mail is delivered via the $virtual_transport mail deliv‐
853              ery transport.
854
855       virtual_mailbox_maps (empty)
856              Optional lookup tables with all valid addresses in  the  domains
857              that match $virtual_mailbox_domains.
858
859       unknown_virtual_mailbox_reject_code (550)
860              The  Postfix  SMTP  server  reply  code when a recipient address
861              matches  $virtual_mailbox_domains,   and   $virtual_mailbox_maps
862              specifies a list of lookup tables that does not match the recip‐
863              ient address.
864

RESOURCE AND RATE CONTROLS

866       The following parameters limit resource usage by the SMTP server and/or
867       control client request rates.
868
869       line_length_limit (2048)
870              Upon  input,  long  lines  are chopped up into pieces of at most
871              this length; upon delivery, long lines are reconstructed.
872
873       queue_minfree (0)
874              The minimal amount of free space in bytes in the queue file sys‐
875              tem that is needed to receive mail.
876
877       message_size_limit (10240000)
878              The  maximal  size in bytes of a message, including envelope in‐
879              formation.
880
881       smtpd_recipient_limit (1000)
882              The maximal number of recipients that the  Postfix  SMTP  server
883              accepts per message delivery request.
884
885       smtpd_timeout (normal: 300s, overload: 10s)
886              When  the  Postfix  SMTP server wants to send an SMTP server re‐
887              sponse, how long the Postfix SMTP server will wait for an under‐
888              lying  network write operation to complete; and when the Postfix
889              SMTP server Postfix wants to receive an SMTP client request, how
890              long the Postfix SMTP server will wait for an underlying network
891              read operation to complete.
892
893       smtpd_history_flush_threshold (100)
894              The maximal number of lines in the Postfix SMTP  server  command
895              history  before it is flushed upon receipt of EHLO, RSET, or end
896              of DATA.
897
898       Available in Postfix version 2.3 and later:
899
900       smtpd_peername_lookup (yes)
901              Attempt to look up the remote SMTP client hostname,  and  verify
902              that the name matches the client IP address.
903
904       The per SMTP client connection count and request rate limits are imple‐
905       mented in co-operation with the anvil(8) service, and are available  in
906       Postfix version 2.2 and later.
907
908       smtpd_client_connection_count_limit (50)
909              How  many simultaneous connections any client is allowed to make
910              to this service.
911
912       smtpd_client_connection_rate_limit (0)
913              The maximal number of connection attempts any client is  allowed
914              to make to this service per time unit.
915
916       smtpd_client_message_rate_limit (0)
917              The  maximal number of message delivery requests that any client
918              is allowed to make to this service per time unit, regardless  of
919              whether or not Postfix actually accepts those messages.
920
921       smtpd_client_recipient_rate_limit (0)
922              The maximal number of recipient addresses that any client is al‐
923              lowed to send to this  service  per  time  unit,  regardless  of
924              whether or not Postfix actually accepts those recipients.
925
926       smtpd_client_event_limit_exceptions ($mynetworks)
927              Clients  that  are excluded from smtpd_client_*_count/rate_limit
928              restrictions.
929
930       Available in Postfix version 2.3 and later:
931
932       smtpd_client_new_tls_session_rate_limit (0)
933              The maximal number of new (i.e., uncached) TLS sessions  that  a
934              remote SMTP client is allowed to negotiate with this service per
935              time unit.
936
937       Available in Postfix version 2.9 - 3.6:
938
939       smtpd_per_record_deadline (normal: no, overload: yes)
940              Change  the  behavior  of  the  smtpd_timeout  and  smtpd_start‐
941              tls_timeout  time  limits,  from  a time limit per read or write
942              system call, to a time limit  to  send  or  receive  a  complete
943              record  (an  SMTP command line, SMTP response line, SMTP message
944              content line, or TLS protocol message).
945
946       Available in Postfix version 3.1 and later:
947
948       smtpd_client_auth_rate_limit (0)
949              The maximal number of AUTH commands that any client  is  allowed
950              to  send to this service per time unit, regardless of whether or
951              not Postfix actually accepts those commands.
952
953       Available in Postfix version 3.7 and later:
954
955       smtpd_per_request_deadline (normal: no, overload: yes)
956              Change  the  behavior  of  the  smtpd_timeout  and  smtpd_start‐
957              tls_timeout  time limits, from a time limit per plaintext or TLS
958              read or write call, to a combined time  limit  for  receiving  a
959              complete SMTP request and for sending a complete SMTP response.
960
961       smtpd_min_data_rate (500)
962              The  minimum  plaintext  data  transfer rate in bytes/second for
963              DATA  and  BDAT  requests,  when  deadlines  are  enabled   with
964              smtpd_per_request_deadline.
965
966       header_from_format (standard)
967              The format of the Postfix-generated From: header.
968
969       Available in Postfix version 3.8 and later:
970
971       smtpd_client_ipv4_prefix_length (32)
972              Aggregate  smtpd_client_*_count  and smtpd_client_*_rate statis‐
973              tics by IPv4 network blocks with the specified network prefix.
974
975       smtpd_client_ipv6_prefix_length (84)
976              Aggregate smtpd_client_*_count and  smtpd_client_*_rate  statis‐
977              tics by IPv6 network blocks with the specified network prefix.
978
979       Available in Postfix 3.9, 3.8.1, 3.7.6, 3.6.10, 3.5.20 and later:
980
981       smtpd_forbid_unauth_pipelining (Postfix >= 3.9: yes)
982              Disconnect  remote  SMTP clients that violate RFC 2920 (or 5321)
983              command pipelining constraints.
984

TARPIT CONTROLS

986       When a remote SMTP client makes errors, the Postfix SMTP server can in‐
987       sert  delays  before  responding.  This  can help to slow down run-away
988       software.  The behavior is controlled by an error counter  that  counts
989       the number of errors within an SMTP session that a client makes without
990       delivering mail.
991
992       smtpd_error_sleep_time (1s)
993              With Postfix version 2.1 and later: the SMTP server response de‐
994              lay  after  a  client has made more than $smtpd_soft_error_limit
995              errors, and fewer than $smtpd_hard_error_limit  errors,  without
996              delivering mail.
997
998       smtpd_soft_error_limit (10)
999              The  number  of  errors  a remote SMTP client is allowed to make
1000              without delivering mail before the  Postfix  SMTP  server  slows
1001              down all its responses.
1002
1003       smtpd_hard_error_limit (normal: 20, overload: 1)
1004              The  maximal number of errors a remote SMTP client is allowed to
1005              make without delivering mail.
1006
1007       smtpd_junk_command_limit (normal: 100, overload: 1)
1008              The number of junk commands (NOOP, VRFY, ETRN or  RSET)  that  a
1009              remote  SMTP  client  can  send  before  the Postfix SMTP server
1010              starts to increment the error counter with each junk command.
1011
1012       Available in Postfix version 2.1 and later:
1013
1014       smtpd_recipient_overshoot_limit (1000)
1015              The number of recipients that a remote SMTP client can  send  in
1016              excess  of  the limit specified with $smtpd_recipient_limit, be‐
1017              fore the Postfix SMTP server increments  the  per-session  error
1018              count for each excess recipient.
1019

ACCESS POLICY DELEGATION CONTROLS

1021       As  of version 2.1, Postfix can be configured to delegate access policy
1022       decisions to an external server that runs  outside  Postfix.   See  the
1023       file SMTPD_POLICY_README for more information.
1024
1025       smtpd_policy_service_max_idle (300s)
1026              The  time after which an idle SMTPD policy service connection is
1027              closed.
1028
1029       smtpd_policy_service_max_ttl (1000s)
1030              The time after which an active SMTPD policy  service  connection
1031              is closed.
1032
1033       smtpd_policy_service_timeout (100s)
1034              The  time limit for connecting to, writing to, or receiving from
1035              a delegated SMTPD policy server.
1036
1037       Available in Postfix version 3.0 and later:
1038
1039       smtpd_policy_service_default_action  (451  4.3.5  Server  configuration
1040       problem)
1041              The default action when an SMTPD policy service request fails.
1042
1043       smtpd_policy_service_request_limit (0)
1044              The  maximal number of requests per SMTPD policy service connec‐
1045              tion, or zero (no limit).
1046
1047       smtpd_policy_service_try_limit (2)
1048              The maximal number of attempts to send an SMTPD  policy  service
1049              request before giving up.
1050
1051       smtpd_policy_service_retry_delay (1s)
1052              The  delay between attempts to resend a failed SMTPD policy ser‐
1053              vice request.
1054
1055       Available in Postfix version 3.1 and later:
1056
1057       smtpd_policy_service_policy_context (empty)
1058              Optional information that the Postfix SMTP server  specifies  in
1059              the  "policy_context"  attribute  of  a  policy  service request
1060              (originally, to share the same service endpoint  among  multiple
1061              check_policy_service clients).
1062

ACCESS CONTROLS

1064       The  SMTPD_ACCESS_README document gives an introduction to all the SMTP
1065       server access control features.
1066
1067       smtpd_delay_reject (yes)
1068              Wait   until   the   RCPT   TO   command    before    evaluating
1069              $smtpd_client_restrictions,     $smtpd_helo_restrictions     and
1070              $smtpd_sender_restrictions, or wait until the ETRN  command  be‐
1071              fore  evaluating  $smtpd_client_restrictions and $smtpd_helo_re‐
1072              strictions.
1073
1074       parent_domain_matches_subdomains (see 'postconf -d' output)
1075              A list of Postfix features where the pattern "example.com"  also
1076              matches  subdomains  of example.com, instead of requiring an ex‐
1077              plicit ".example.com" pattern.
1078
1079       smtpd_client_restrictions (empty)
1080              Optional restrictions that the Postfix SMTP  server  applies  in
1081              the context of a client connection request.
1082
1083       smtpd_helo_required (no)
1084              Require  that  a  remote  SMTP client introduces itself with the
1085              HELO or EHLO command before sending the MAIL  command  or  other
1086              commands that require EHLO negotiation.
1087
1088       smtpd_helo_restrictions (empty)
1089              Optional  restrictions  that  the Postfix SMTP server applies in
1090              the context of a client HELO command.
1091
1092       smtpd_sender_restrictions (empty)
1093              Optional restrictions that the Postfix SMTP  server  applies  in
1094              the context of a client MAIL FROM command.
1095
1096       smtpd_recipient_restrictions (see 'postconf -d' output)
1097              Optional  restrictions  that  the Postfix SMTP server applies in
1098              the context of a client RCPT TO command,  after  smtpd_relay_re‐
1099              strictions.
1100
1101       smtpd_etrn_restrictions (empty)
1102              Optional  restrictions  that  the Postfix SMTP server applies in
1103              the context of a client ETRN command.
1104
1105       allow_untrusted_routing (no)
1106              Forward  mail  with   sender-specified   routing   (user[@%!]re‐
1107              mote[@%!]site)  from  untrusted clients to destinations matching
1108              $relay_domains.
1109
1110       smtpd_restriction_classes (empty)
1111              User-defined aliases for groups of access restrictions.
1112
1113       smtpd_null_access_lookup_key (<>)
1114              The lookup key to be used in SMTP access(5)  tables  instead  of
1115              the null sender address.
1116
1117       permit_mx_backup_networks (empty)
1118              Restrict  the use of the permit_mx_backup SMTP access feature to
1119              only domains whose primary MX hosts match the listed networks.
1120
1121       Available in Postfix version 2.0 and later:
1122
1123       smtpd_data_restrictions (empty)
1124              Optional access restrictions that the Postfix  SMTP  server  ap‐
1125              plies in the context of the SMTP DATA command.
1126
1127       smtpd_expansion_filter (see 'postconf -d' output)
1128              What  characters  are  allowed  in $name expansions of RBL reply
1129              templates.
1130
1131       Available in Postfix version 2.1 and later:
1132
1133       smtpd_reject_unlisted_sender (no)
1134              Request that the Postfix SMTP server rejects mail  from  unknown
1135              sender  addresses,  even when no explicit reject_unlisted_sender
1136              access restriction is specified.
1137
1138       smtpd_reject_unlisted_recipient (yes)
1139              Request that the Postfix SMTP server rejects  mail  for  unknown
1140              recipient  addresses,  even when no explicit reject_unlisted_re‐
1141              cipient access restriction is specified.
1142
1143       Available in Postfix version 2.2 and later:
1144
1145       smtpd_end_of_data_restrictions (empty)
1146              Optional access restrictions that the Postfix  SMTP  server  ap‐
1147              plies in the context of the SMTP END-OF-DATA command.
1148
1149       Available in Postfix version 2.10 and later:
1150
1151       smtpd_relay_restrictions (permit_mynetworks, permit_sasl_authenticated,
1152       defer_unauth_destination)
1153              Access restrictions for mail relay control that the Postfix SMTP
1154              server  applies  in  the  context of the RCPT TO command, before
1155              smtpd_recipient_restrictions.
1156

SENDER AND RECIPIENT ADDRESS VERIFICATION CONTROLS

1158       Postfix version 2.1 introduces sender and recipient  address  verifica‐
1159       tion.  This feature is implemented by sending probe email messages that
1160       are not actually delivered.  This feature  is  requested  via  the  re‐
1161       ject_unverified_sender  and reject_unverified_recipient access restric‐
1162       tions.  The status of verification probes is  maintained  by  the  ver‐
1163       ify(8)  server.   See the file ADDRESS_VERIFICATION_README for informa‐
1164       tion about how to configure and operate  the  Postfix  sender/recipient
1165       address verification service.
1166
1167       address_verify_poll_count (normal: 3, overload: 1)
1168              How many times to query the verify(8) service for the completion
1169              of an address verification request in progress.
1170
1171       address_verify_poll_delay (3s)
1172              The delay between queries for the completion of an address veri‐
1173              fication request in progress.
1174
1175       address_verify_sender ($double_bounce_sender)
1176              The  sender address to use in address verification probes; prior
1177              to Postfix 2.5 the default was "postmaster".
1178
1179       unverified_sender_reject_code (450)
1180              The numerical Postfix SMTP server response code when a recipient
1181              address is rejected by the reject_unverified_sender restriction.
1182
1183       unverified_recipient_reject_code (450)
1184              The  numerical Postfix SMTP server response when a recipient ad‐
1185              dress is rejected by  the  reject_unverified_recipient  restric‐
1186              tion.
1187
1188       Available in Postfix version 2.6 and later:
1189
1190       unverified_sender_defer_code (450)
1191              The  numerical  Postfix  SMTP server response code when a sender
1192              address probe fails due to a temporary error condition.
1193
1194       unverified_recipient_defer_code (450)
1195              The numerical Postfix SMTP server response when a recipient  ad‐
1196              dress probe fails due to a temporary error condition.
1197
1198       unverified_sender_reject_reason (empty)
1199              The  Postfix  SMTP  server's  reply when rejecting mail with re‐
1200              ject_unverified_sender.
1201
1202       unverified_recipient_reject_reason (empty)
1203              The Postfix SMTP server's reply when  rejecting  mail  with  re‐
1204              ject_unverified_recipient.
1205
1206       unverified_sender_tempfail_action ($reject_tempfail_action)
1207              The  Postfix  SMTP server's action when reject_unverified_sender
1208              fails due to a temporary error condition.
1209
1210       unverified_recipient_tempfail_action ($reject_tempfail_action)
1211              The Postfix SMTP server's action when  reject_unverified_recipi‐
1212              ent fails due to a temporary error condition.
1213
1214       Available with Postfix 2.9 and later:
1215
1216       address_verify_sender_ttl (0s)
1217              The  time  between  changes in the time-dependent portion of ad‐
1218              dress verification probe sender addresses.
1219

ACCESS CONTROL RESPONSES

1221       The following parameters control numerical SMTP reply codes and/or text
1222       responses.
1223
1224       access_map_reject_code (554)
1225              The numerical Postfix SMTP server response code for an access(5)
1226              map "reject" action.
1227
1228       defer_code (450)
1229              The numerical Postfix SMTP server response code  when  a  remote
1230              SMTP client request is rejected by the "defer" restriction.
1231
1232       invalid_hostname_reject_code (501)
1233              The  numerical Postfix SMTP server response code when the client
1234              HELO or EHLO command parameter is  rejected  by  the  reject_in‐
1235              valid_helo_hostname restriction.
1236
1237       maps_rbl_reject_code (554)
1238              The  numerical  Postfix  SMTP server response code when a remote
1239              SMTP client request is blocked  by  the  reject_rbl_client,  re‐
1240              ject_rhsbl_client,        reject_rhsbl_reverse_client,       re‐
1241              ject_rhsbl_sender or reject_rhsbl_recipient restriction.
1242
1243       non_fqdn_reject_code (504)
1244              The numerical Postfix SMTP server reply code when a  client  re‐
1245              quest  is  rejected  by  the  reject_non_fqdn_helo_hostname, re‐
1246              ject_non_fqdn_sender or reject_non_fqdn_recipient restriction.
1247
1248       plaintext_reject_code (450)
1249              The numerical Postfix SMTP server response code when  a  request
1250              is rejected by the reject_plaintext_session restriction.
1251
1252       reject_code (554)
1253              The  numerical  Postfix  SMTP server response code when a remote
1254              SMTP client request is rejected by the "reject" restriction.
1255
1256       relay_domains_reject_code (554)
1257              The numerical Postfix SMTP server response code  when  a  client
1258              request  is  rejected by the reject_unauth_destination recipient
1259              restriction.
1260
1261       unknown_address_reject_code (450)
1262              The numerical response code when the Postfix SMTP server rejects
1263              a sender or recipient address because its domain is unknown.
1264
1265       unknown_client_reject_code (450)
1266              The  numerical  Postfix  SMTP server response code when a client
1267              without valid address <=> name mapping is rejected  by  the  re‐
1268              ject_unknown_client_hostname restriction.
1269
1270       unknown_hostname_reject_code (450)
1271              The  numerical  Postfix SMTP server response code when the host‐
1272              name specified with the HELO or EHLO command is rejected by  the
1273              reject_unknown_helo_hostname restriction.
1274
1275       Available in Postfix version 2.0 and later:
1276
1277       default_rbl_reply (see 'postconf -d' output)
1278              The  default Postfix SMTP server response template for a request
1279              that is rejected by an RBL-based restriction.
1280
1281       multi_recipient_bounce_reject_code (550)
1282              The numerical Postfix SMTP server response code  when  a  remote
1283              SMTP  client  request  is  blocked  by  the reject_multi_recipi‐
1284              ent_bounce restriction.
1285
1286       rbl_reply_maps (empty)
1287              Optional lookup tables with RBL response templates.
1288
1289       Available in Postfix version 2.6 and later:
1290
1291       access_map_defer_code (450)
1292              The numerical Postfix SMTP server response code for an access(5)
1293              map "defer" action, including "defer_if_permit" or "defer_if_re‐
1294              ject".
1295
1296       reject_tempfail_action (defer_if_permit)
1297              The Postfix SMTP server's action when a reject-type  restriction
1298              fails due to a temporary error condition.
1299
1300       unknown_helo_hostname_tempfail_action ($reject_tempfail_action)
1301              The  Postfix SMTP server's action when reject_unknown_helo_host‐
1302              name fails due to a temporary error condition.
1303
1304       unknown_address_tempfail_action ($reject_tempfail_action)
1305              The Postfix SMTP server's action when  reject_unknown_sender_do‐
1306              main  or reject_unknown_recipient_domain fail due to a temporary
1307              error condition.
1308

MISCELLANEOUS CONTROLS

1310       config_directory (see 'postconf -d' output)
1311              The default location of the Postfix main.cf and  master.cf  con‐
1312              figuration files.
1313
1314       daemon_timeout (18000s)
1315              How  much time a Postfix daemon process may take to handle a re‐
1316              quest before it is terminated by a built-in watchdog timer.
1317
1318       command_directory (see 'postconf -d' output)
1319              The location of all postfix administrative commands.
1320
1321       double_bounce_sender (double-bounce)
1322              The sender address of postmaster notifications that  are  gener‐
1323              ated by the mail system.
1324
1325       ipc_timeout (3600s)
1326              The  time limit for sending or receiving information over an in‐
1327              ternal communication channel.
1328
1329       mail_name (Postfix)
1330              The mail system name that is displayed in Received: headers,  in
1331              the SMTP greeting banner, and in bounced mail.
1332
1333       mail_owner (postfix)
1334              The  UNIX  system  account  that owns the Postfix queue and most
1335              Postfix daemon processes.
1336
1337       max_idle (100s)
1338              The maximum amount of time that an idle Postfix  daemon  process
1339              waits for an incoming connection before terminating voluntarily.
1340
1341       max_use (100)
1342              The maximal number of incoming connections that a Postfix daemon
1343              process will service before terminating voluntarily.
1344
1345       myhostname (see 'postconf -d' output)
1346              The internet hostname of this mail system.
1347
1348       mynetworks (see 'postconf -d' output)
1349              The list of "trusted" remote SMTP clients that have more  privi‐
1350              leges than "strangers".
1351
1352       myorigin ($myhostname)
1353              The  domain  name that locally-posted mail appears to come from,
1354              and that locally posted mail is delivered to.
1355
1356       process_id (read-only)
1357              The process ID of a Postfix command or daemon process.
1358
1359       process_name (read-only)
1360              The process name of a Postfix command or daemon process.
1361
1362       queue_directory (see 'postconf -d' output)
1363              The location of the Postfix top-level queue directory.
1364
1365       recipient_delimiter (empty)
1366              The set of characters that can separate an email address  local‐
1367              part, user name, or a .forward file name from its extension.
1368
1369       smtpd_banner ($myhostname ESMTP $mail_name)
1370              The  text  that follows the 220 status code in the SMTP greeting
1371              banner.
1372
1373       syslog_facility (mail)
1374              The syslog facility of Postfix logging.
1375
1376       syslog_name (see 'postconf -d' output)
1377              A prefix that  is  prepended  to  the  process  name  in  syslog
1378              records, so that, for example, "smtpd" becomes "prefix/smtpd".
1379
1380       Available in Postfix version 2.2 and later:
1381
1382       smtpd_forbidden_commands (CONNECT GET POST regexp:{{/^[^A-Z]/ Bogus}})
1383              List  of  commands that cause the Postfix SMTP server to immedi‐
1384              ately terminate the session with a 221 code.
1385
1386       Available in Postfix version 2.5 and later:
1387
1388       smtpd_client_port_logging (no)
1389              Enable logging of the remote SMTP client port in addition to the
1390              hostname and IP address.
1391
1392       Available in Postfix 3.3 and later:
1393
1394       service_name (read-only)
1395              The master.cf service name of a Postfix daemon process.
1396
1397       Available in Postfix 3.4 and later:
1398
1399       smtpd_reject_footer_maps (empty)
1400              Lookup  tables,  indexed by the complete Postfix SMTP server 4xx
1401              or 5xx response, with reject footer templates.
1402

SEE ALSO

1404       anvil(8), connection/rate limiting
1405       cleanup(8), message canonicalization
1406       tlsmgr(8), TLS session and PRNG management
1407       trivial-rewrite(8), address resolver
1408       verify(8), address verification service
1409       postconf(5), configuration parameters
1410       master(5), generic daemon options
1411       master(8), process manager
1412       postlogd(8), Postfix logging
1413       syslogd(8), system logging
1414

README FILES

1416       Use "postconf readme_directory" or "postconf html_directory" to  locate
1417       this information.
1418       ADDRESS_CLASS_README, blocking unknown hosted or relay recipients
1419       ADDRESS_REWRITING_README, Postfix address manipulation
1420       BDAT_README, Postfix CHUNKING support
1421       FILTER_README, external after-queue content filter
1422       LOCAL_RECIPIENT_README, blocking unknown local recipients
1423       MILTER_README, before-queue mail filter applications
1424       SMTPD_ACCESS_README, built-in access policies
1425       SMTPD_POLICY_README, external policy server
1426       SMTPD_PROXY_README, external before-queue content filter
1427       SASL_README, Postfix SASL howto
1428       TLS_README, Postfix STARTTLS howto
1429       VERP_README, Postfix XVERP extension
1430       XCLIENT_README, Postfix XCLIENT extension
1431       XFORWARD_README, Postfix XFORWARD extension
1432

LICENSE

1434       The Secure Mailer license must be distributed with this software.
1435

AUTHOR(S)

1437       Wietse Venema
1438       IBM T.J. Watson Research
1439       P.O. Box 704
1440       Yorktown Heights, NY 10598, USA
1441
1442       Wietse Venema
1443       Google, Inc.
1444       111 8th Avenue
1445       New York, NY 10011, USA
1446
1447       SASL support originally by:
1448       Till Franke
1449       SuSE Rhein/Main AG
1450       65760 Eschborn, Germany
1451
1452       TLS support originally by:
1453       Lutz Jaenicke
1454       BTU Cottbus
1455       Allgemeine Elektrotechnik
1456       Universitaetsplatz 3-4
1457       D-03044 Cottbus, Germany
1458
1459       Revised TLS support by:
1460       Victor Duchovni
1461       Morgan Stanley
1462
1463
1464
1465                                                                      SMTPD(8)
Impressum