  Basic Postfix Configurations
  Cristiano Otto Von Trompczynski


  11..  LLooccaall ppaatthh iinnffoorrmmaattiioonn


     QQuueeuuee ddiirreeccttoorryy
        The "Queue directory" option specifies the location of the
        Postfix queue.  This is also the root directory of Postfix
        daemons that run chrooted.  See the files in examples/chroot-
        setup/ for setting up Postfix chroot environments on different
        UNIX systems. This option sets the "queue_directory" postfix
        variable.


     CCoommmmaanndd ddiirreeccttoorryy
        The "Command directory" option specifies the location of all
        postXXX commands. The default value is taken from the "Program
        directory" option in Miscellaneous. This option sets the
        "command_directory" postfix variable.


     DDaaeemmoonn ddiirreeccttoorryy
        The "Daemon directory" option specifies the location of all
        Postfix daemon programs (i.e. programs listed in the master.cf
        file). The default value is taken from the "Program directory"
        option in Miscellaneous. This directory must be owned by root.
        This option sets the "daemon_directory" postfix variable.


  22..  QQuueeuuee aanndd pprroocceessss oowwnneerrsshhiipp


     MMaaiill oowwnneerr
        The "Mail owner" option specifies the owner of the Postfix queue
        and of most "Postfix daemon processes".  Specify the name of  a
        user account THAT DOES NOT SHARE A GROUP WITH OTHER ACCOUNTS AND
        THAT OWNS NO OTHER FILES OR PROCESSES ON THE SYSTEM.  In
        particular, don't specify nobody or daemon. PLEASE USE A
        DEDICATED USER.  This option sets the "mail_owner" postfix
        variable.


     DDeeffaauulltt pprriivviilleeggeess
        The "Default privileges" option specifies the default rights
        used by the local delivery agent for delivery to external file
        or command.  These rights are used in the absence of a recipient
        user context.  DO NOT SPECIFY A PRIVILEGED USER OR THE POSTFIX
        OWNER. This option sets the "default_privs" postfix variable.


  33..  IInntteerrnneett hhoosstt aanndd ddoommaaiinn nnaammeess


     HHoossttnnaammee
        The "Hostname" option specifies the "internet hostname" of this
        mail system. The default is to use the fully-qualified domain
        name from gethostname(). The "Hostname" option is used as a
        default value for many other configuration parameters. This
        option sets the "myhostname" postfix variable.

     DDoommaaiinn
        The "Domain" option specifies the local internet domain name.
        The default is to use the contents of "Hostname" minus the first
        component. The "Domain" option is used as a default value for
        many other configuration parameters. This option sets the
        "mydomain" postfix variable.


  44..  SSeennddiinngg mmaaiill


     OOrriiggiinn
        The "Origin" option specifies the domain that locally-posted
        mail appears to come from. The default is to append "hostname",
        which is fine for small sites.  If you run a domain with
        multiple machines, you should (1) change this to "domain" and
        (2) set up a domain-wide alias database that aliases each user
        to user@that.users.mailhost. This option sets the "myorigin"
        postfix variable.


  55..  RReecceeiivviinngg mmaaiill


     NNeettwwoorrkk iinntteerrffaaccee
        The "Network interfaces" option specifies the network interface
        addresses that this mail system receives mail on.  By default,
        the software claims _a_l_l active interfaces on the machine. The
        parameter also controls delivery of mail to user@[ip.address].
        This option sets the "inet_interfaces" postfix variable.


     DDeessttiinnaattiioonn
        The "Destination" option specifies the list of domains that this
        machine considers itself the final destination for. That does
        not include domains that are hosted on this machine. Those
        domains are specified elsewhere (see sample-virtual.cf, and
        sample-transport.cf).

        The default is "myhostname + localhost.$mydomain". On a mail
        domain gateway, you should also include "$mydomain". Do not
        specify the names  of  domains  that  this  machine  is  backup
        MX  host  for.  Specify those  names  via  the  "Relay domains"
        option  in

        The local machine is always the final destination for mail
        addressed to user@[the.net.work.address] of an interface that
        the mail system receives mail on (see the Inet interfaces help).

        Specify a list of host or domain names, /file/name or type:table
        patterns, separated by commas and/or whitespace. A /file/name
        pattern is replaced by its contents; a type:table is matched
        when a name matches a lookup key. This option sets the
        "inet_interfaces" postfix variable.

        DO NOT LIST VIRTUAL DOMAINS HERE. LIST THEM IN THE
        TABLE->VIRTUAL ITEM INSTEAD. BE SURE TO READ THE ENTIRE VIRTUAL
        MANUAL PAGE.


  66..  RReejjeeccttiinngg uunnkknnoowwnn llooccaall uusseerrss


     LLooccaall rreecciippiieenntt mmaappss
        The "Local recipient maps" option specifies optional lookup
        tables with all users that are local with respect to
        "$mydestination" and "$inet_interfaces".  If this parameter is
        defined, then the SMTP server will reject mail for unknown local
        users.

        The "Local recipient maps" option accepts tables with bare
        usernames such as unix:passwd.byname and alias maps.

        Beware: if the Postfix SMTP server runs chrooted, you may have
        to copy the passwd database into the jail. This is system
        dependent.

        This option sets the "local_recipient_maps" postfix variable.

        FOR THIS TO WORK, DO NOT SPECIFY VIRTUAL DOMAINS IN
        MYDESTINATION.  MYDESTINATION MUST LIST NON-VIRTUAL DOMAINS
        ONLY.


  77..  DDeebbuuggggiinngg ccoonnttrrooll


     DDeebbuugg ppeeeerr lleevveell
        The "Debug peer level" option specifies the increment in verbose
        logging level when an SMTP client or server host name or address
        matches a pattern in the "Debug peer list" option. This option
        sets the "debug_peer_level" postfix variable.


     DDeebbuugg ppeeeerr lliisstt
        The "Debug peer list" option specifies an optional list of
        domain or network patterns, /file/name patterns or type:name
        tables. When an SMTP client or server host name or address
        matches a pattern, increase the verbose logging level by the
        amount specified in the "Debug peer level" option. This option
        sets the "debug_peer_list" postfix variable.


     DDeebbuuggggeerr ccoommmmaanndd
        The "Debugger command" option specifies the external command
        that is executed when a Postfix daemon program is run with the
        -D option.

        Use "command .. & sleep 5" so that the debugger can attach
        before the process marches on. If you use an X-based debugger,
        be sure to set up your XAUTHORITY environment variable before
        starting Postfix.  This option sets the "debugger_command"
        postfix variable.