NAME

       chasquid.conf(5) -- chasquid configuration file

SYNOPSIS

       chasquid.conf(5) is chasquid(1)'s main configuration file.

DESCRIPTION

       The file is in protocol buffers' text format.

       Comments start with "#". Empty lines are allowed.  Values are of the form "key: value". Values can be
       strings (quoted), integers, or booleans ("true" or "false").

       Some values might be repeated, for example the listening addresses.

OPTIONS

       hostname (string):
               Default  hostname  to  use when saying hello. This is used to say hello to clients, for aesthetic
               purposes. Default: the system's hostname.

       max_data_size_mb (int):
               Maximum email size, in megabytes. Default: 50.

       smtp_address (repeated string):
               Addresses to listen on for SMTP (usually port 25). Default: "systemd", which means systemd passes
               sockets to us. systemd sockets must be named with FileDescriptorName=smtp.

       submission_address (repeated string):
               Addresses to listen on for submission (usually port 587). Default: "systemd", which means systemd
               passes sockets to us. systemd sockets must be named with FileDescriptorName=submission.

       submission_over_tls_address (repeated string):
               Addresses to listen on for submission-over-TLS (usually  port  465).  Default:  "systemd",  which
               means    systemd    passes    sockets    to    us.   systemd   sockets   must   be   named   with
               FileDescriptorName=submission_tls.

       monitoring_address (string):
               Address for the monitoring HTTP server. Do NOT expose this to the public  internet.  Default:  no
               monitoring server.

       mail_delivery_agent_bin (string):
               Mail  delivery  agent  (MDA, also known as LDA) to use. This should point to the binary to use to
               deliver email to local users. The content of the email will be passed  via  stdin.  If  it  exits
               unsuccessfully, we assume the mail was not delivered. Default: maildrop.

       mail_delivery_agent_args (repeated string):
               Command  line arguments for the mail delivery agent. One per argument.  Some replacements will be
               done.

               On an email sent from marsnik@mars to venera@venus:

                   %from%        -> from address (marsnik@mars)
                   %from_user%   -> from user (marsnik)
                   %from_domain% -> from domain (mars)
                   %to%          -> to address (venera@venus)
                   %to_user%     -> to user (venera)
                   %to_domain%   -> to domain (venus)

               Default: "-f", "%from%", "-d", "%to_user%"  (adequate for procmail and maildrop).

       data_dir (string):
               Directory where we store our persistent data. Default: /var/lib/chasquid.

       suffix_separators (string):
               Suffix separator, to perform suffix removal of local users.  For example,  if  you  set  this  to
               "-+", email to local user "user-blah" and "user+blah" will be delivered to "user".  Including "+"
               is strongly encouraged, as it is assumed for email forwarding.  Default: "+".

       drop_characters (string):
               Characters  to  drop  from  the user part on local emails.  For example, if you set this to "._",
               email to local user "u.se_r" will be delivered to "user".  Default: ".".

       mail_log_path (string):
               Path where to write the mail log to.   If  "<syslog>",  log  using  the  syslog  (at  "MAIL|INFO"
               priority).  Default: "<syslog>".

       dovecot_auth (bool):
               Enable  dovecot authentication. If true, users that are not found in chasquid's databases will be
               authenticated via dovecot.  Default: "false".

               The path to dovecot's auth sockets is autodetected, but can  be  manually  overridden  using  the
               "dovecot_userdb_path" and "dovecot_client_path" if needed.

SEE ALSO

       chasquid(1)

                                                   2019-07-15                                   chasquid.conf(5)