diff options
Diffstat (limited to 'minimalist.conf-sample')
| -rw-r--r-- | minimalist.conf-sample | 406 |
1 files changed, 406 insertions, 0 deletions
diff --git a/minimalist.conf-sample b/minimalist.conf-sample new file mode 100644 index 0000000..d25083e --- /dev/null +++ b/minimalist.conf-sample @@ -0,0 +1,406 @@ +############## Main configuration file for Minimalist ################ + +#--------------------------------------------------------------------# +# These directives can be used only in global config # +#--------------------------------------------------------------------# + +# The directory for Minimalist's files - default to /var/spool/minimalist +# +#directory = /var/spool/minimalist + +# Administrator password. It applies to all lists, regardless to +# authentication settings in these lists. For per-list authentication see +# directive 'auth' below. +# +# Password must be in very first line and first column of message's body, +# as follows (without quotes): '*password: this_secret_password' +# +# By default this password isn't empty, but undefined, so if you want use +# it, you must define it here. +# +#password = this_secret_password + +# Time while authentication request is valid, in hours +# Default to 24 hours +# +#request valid = 12 + +# Access control list, used for limiting access to Minimalist. Delimiter +# for items is ':'. Item, which begins with '@', means path to filename +# with items list, one item per row. +# +# Default is empty +# +#blacklist = !small.domain.com:domain.com:spamdomain.org:@/path/to/blacklist.txt +# +# In this example mails from small.domain.com will be allowed to work with +# Minimalist, mails from domain.com will be disallowed, and further, on the +# 'first match' basis. + +# Robots (like MLM=mailing list managers) usually should be blocked +# otherwise two minimalists could be ping-ponging help/subscribe messages +# to each other infinitely. Delimiter is '|'. +# +#blocked robots = 'X-List-Server|List-Id|List-Subscribe|X-Yahoo-Newman-Property'; + +# Log requests to Minimalist. Can be either "none" or path to logfile. +# +# Default to none +# +#logfile = /var/log/Minimalist.log + +# Log info about messages, passed through Minimalist. Can be 'yes' or 'no' +# +# Default to 'no'. logfile (see above) to 'none' implies 'no' +# +#log messages = yes + +# Run in background. If 'yes', Minimalist uses fork for detach from MTA and +# continues execution in background. +# +# Default to 'no' +# +#background = yes + +# Preprocessing filter. Passes entire incoming message to external program +# (in specified order) for some processing (for example, antivirus +# check). Program MUST return result on standart output. +# +# Default to no filters. +# +#prefilter = /usr/local/bin/antivirus -d /var/spool/avdb : /usr/bin/tee /tmp/message.dbg + +#-------------------------------------------------------------------# +# These directives can be used either in global and local configs # +#-------------------------------------------------------------------# + +# The Minimalist administrator's e-mail address. +# +# Default to postmaster@primary_domain, where primary_domain is the result +# of the `hostname --fqdn` command +# +#admin = doka@kiev.sovam.com + +# Address for return miscellaneous delivery errors +# +# Available values are: +# . drop - drop such error messages +# . admin - send error messages to admin (see above) +# . sender - send error messages to sender of original message +# . verp - generate VERP (see below) +# . RFC-822 E-mail - send error messages to arbitrary mailbox +# +# Default to 'drop'. Note, that 'sender' value is quite annoying for +# message's sender and highly undesirable. When setuping new list it is +# desirable to set this parameter to 'admin' for revealing adimistrator's +# errors. +# +# Note about 'verp' (Variable Envelope Return Path). +# +# Prepare message so, that it will be possible to parse bounce messages. +# For detailed description see original document at +# http://cr.yp.to/proto/verp.txt +# or it's copy at +# http://www.mml.org.ua/verp.txt +# +# You must create one additional alias in your 'aliases' file, for +# processing bounce messages. It must be something similar to: +# +#listname-owner-*: "|/path/to/bouncer.pl" +# +# where 'listname' is the name of mailing list. Wildcard mask specifies, +# that any message, where recipient's address starts on 'listname-owner-', +# will be passed to bouncer.pl. Check your MTA documentation on how to +# creare wilcard aliases. +# +# Distribution of Minimalist does not provide bounce processing program. +# You should use any third-party program. +# +# CAUTION: if value set to 'verp', Minimalist will generate ONE MESSAGE per +# RECIPIENT. On big lists this can produce very big load of server. +# +#errors to = admin + +# The list's language +# en=English / ru=Russian / de=informal German / DE=formal German / +# NL=Dutch +# +# See contrib/languages directory for further information +# +# language = en + +# The charset, which will be used in information messages and footer. +# +# Default is 'us-ascii' +# +# See docs/README for information on how Minimalist adds footer, +# dependently on charset. +# +#charset = koi8-r + +# Path to sendmail, default to '/usr/sbin/sendmail' +# +#sendmail = /usr/sbin/sendmail + +# Delivery method. Can be 'internal' - Minimalist will send message by +# itself and 'alias' - Minimalist will send message to specified address, +# which can points to bulkmailer, etc. +# +# Note, that using 'alias' automatically sets value of 'errors to' to +# 'sender'. +# +# Default to 'internal'. Syntax is: +# +#delivery = internal +#delivery = alias e-mail + +# The domain name - default to `hostname --fqdn`. If begins with '|' then +# Minimalist calls external program to determine hostname. +# +#domain = |uname -n +#domain = kiev.sovam.com + +# Security level: +# . none - allow any person write to any mailing list +# . careful - only subscribers can write to list +# . paranoid - user must authenticate subscribe/unsubscribe requests +# +# Default to 'careful' +# +#security = none + +# Archiving strategy: +# . no - don't archive articles +# . daily - create new directory for articles every day +# . monthly - create new directory for articles every month +# . yearly - create new directory for articles every year +# or +# archive = pipe /path/to/archiver [options] +# +# for instance +# archive = pipe /usr/local/bin/hypermail -m www-talk -d /archives/www-talk +# +# Default to 'no' +# +#archive = monthly + +# Maximum size of message (in bytes), which will be archived +# +# Default - zero (no limits) +# +#archive size = 1000000 + +# List's status. Available values are: +# . open - list without any restrictions +# . ro - read-only access to list +# . closed - only trusted users can subscribe anyone to this list. +# . mandatory - subscribed users can't unsubscribe +# +# Values may be used together, for example: closed,ro,mandatory +# +# Default to 'open' +# +#status = closed,ro,mandatory + +# Copy to sender - indicates send or no message to message's sender +# Default to yes +# +#copy to sender = no + +# This variable defines Reply-To: contents of outgoing message. Available +# choices: 'no', 'yes' or e-mail. If used 'no' (default), Minimalist doesn't +# touch this header at all. If used 'yes', Minimalist sets Reply-To: header +# to list's address instead of original contents. +# +# The third choice is available ONLY in per-list config - if used any other +# value, Reply-To: will be set to this value. BE CAREFUL and use correct +# RFC-822 compliant E-mail here. +# +# Please check the following URL on why you (most often) should not use +# this feature: http://www.unicom.com/pw/reply-to-harmful.html (Thanks to +# Jonas Bofjall for pointing to this topic) +# +# Default to 'no' +# +#reply-to list = yes + +# Set From: to specified value (RFC-822 compliant E-mail address) in +# outgoing message. +# +# Default - don't touch From: +# +#from = doka@kiev.sovam.com + +# Modify subject before sending message to subscribers. +# +# Available values: +# no : don't touch subject +# yes : add "[list_name] " before original subject +# more : remove leading "Re: " if it's there and then add "[list_name] " +# +# Default to yes +# +#modify subject = no + +# Maximal count of subscribers per list, zero means no limits. +# Default to zero +# +#maxusers = 100 + +# Count of recipients per message. If not zero, Minimalist will generate +# few messages with maxrcpts recipients instead of one message to all +# recipients. +# +# Allowed value from 1 to 50, default to 10 +# +# Be careful when using high values, because this may lead to lost some +# recipients in mailing if total length of addresses will exceed allowed +# length of command line, passed to MTA. +# +#maxrcpts = 15 + +# Delay (in seconds) between deliveries, if there are few ones per message. +# +# Default to none +# +#delay = 15 + +# Maximal size of message +# Default to none +# +#maxsize = 100000 + +# Include list information headers (RFC 2369) in outgoing mail. These +# directives are: List-Help, List-Subscribe, List-Unsubscribe, List-Post, +# List-Owner and, optionally, List-Archive. +# +# Available values are: 'no', 'yes' or URL, which points to archive, in +# form: <URL> (Comment) +# +# Example: +# list information = <http://www.yahoo.com/> (Archive of everything) +# +# Note: comment is optional and may be avoided. Using URL as value in this +# directive implies 'yes' to all rest List-* headers and available only in +# per-list config. +# +# Default value is 'yes' +# +#list information = no + +# Strip various "Receipt Request" headers. Currently there are: +# +# . Return-Receipt-To +# . Disposition-Notification-To +# . X-Confirm-Reading-To +# +# Default not to strip +# +#strip rrq = yes + +# Add extra headers. It is possible to use this option two and more times - +# Minimalist will glue all these headers, when producing final message. +# Also it is possible to use macroses (if applicable) \a (admin), \d +# (domain), \l (list), \o (owner), \n (newline), \t (tab) and \s (space) in +# these headers. +# +# WARNING! Minimalist doesn't check validity of these headers nor their +# duplicating! Be carefull while using this option. +# +#extra header = X-BeenThere: \l@\d +# +# By using \n, \t and \s it is possible to construct multiline headers, for +# example: +# +#extra header = X-Multline: first line\n\t second line\n\t third line +# +# the same result may be achieved by combining few directives: +# +#extra header = X-Multilne: first line +#extra header = \t second line +#extra header = \t third line + +# Remove 'Resent-*' headers in incoming mail. These headers are not +# important for message understanding and processing, but some MUA's +# generate incorrect these ones. +# +# Default not to remove. +# +#remove resent = yes + +# Modify Message-ID in outgoing message. +# +# If somefirstbody subscribed on two lists on same server and +# somesecondbody crossposts message to these lists and +# somefirstbody's MTA doesn't allow two and more messages with +# same Message-ID, then this first body will receive message only +# once. In this case modification of original message's Message-ID +# will solve this problem. +# +# Modification is done by adding token 'MMLID_xxxxx-' before the +# original Message-ID, where xxxxx is some number between 0 and 99999 +# +# Default do not touch Message-ID. +# +#modify message-id = yes + +# Send message on subscribe/unsubscribe event to list owner +# +# Default to no +# +#cc on subscribe = yes + +#------------------------------------------------------------------# +# These directives can be used in local configs only # +#------------------------------------------------------------------# + +# Authentication scheme for list. +# +# NOTE: By default there is 'password' scheme with undefined password, so +# if you want to make administrative requests to list, you must define this +# scheme explicitly. +# +# Examples: +# +# auth = mailfrom doka@kiev.sovam.com:@/usr/local/etc/list.admins +# List users, allowed to make administrative requests. Their e-mails +# delimited by ':', item, beginnig with '@' means filename with list +# of persons, one person's e-mail per one row. +# +# auth = password this_secret_password +# Password, which opens administrative access to list. Must be in +# very first line and first column of message's body, as follows +# (without quotes): '*password: this_secret_password' +# +#auth = mailfrom doka@kiev.sovam.com:@/usr/local/etc/mml.trusted +#auth = password this_secret_password + +# List's GECOS. +# +# Add gecos to headers 'To' and, optionally, 'Reply-To', when sending +# message to subscribers. For example, using: +# +# list gecos = Minimalist General Discussion +# +# will produce +# +# To: Minimalist General Discussion <mml-general@kiev.sovam.com> +# Reply-To: Minimalist General Discussion <mml-general@kiev.sovam.com> +# +# in outgoing message. +# +# Default: empty +# +#list gecos = Test GECOS + +# Fill header 'To' of outgoing message with recipient's address. +# +# Note: if set to 'yes', Minimalist will remove all rest 'To' and 'Cc' +# headers from message. +# +# CAUTION: if set to 'yes', Minimalist will generate ONE MESSAGE per +# RECIPIENT. On big lists this can produce very big load of server. +# +# Default to 'no' +# +#to recipient = yes |