Personal tools
You are here: Home Support Documentation Email x54.html
Document Actions

x54.html

Per-Folder Options

Per-Folder Options

After selecting a folder, the system then checks another file in the user's $HOME directory, ~/Maildir.conf to get options on delivery which may apply to that folder. These options control things like whether to do spam checking for messages (we don't for mail to folders postmaster, security, or abuse as they may well be spam reports). The following sample has most of the options in use with comments. I will go into more detail on the more generally useful options below.


# Maildir.conf, Mailbox configuration file.
#
# The options here in the DEFAULT section apply to all folders,
# and may be overridden in the folder sections.
[DEFAULT]
# set True for debugging output to /tmp/deliver.username
debug: False

# Set dupsok to allow duplicate messages

dupsok: False

# if dupsok isn't True, you can set this to specify another
# mailbox for delivery (e.g. spam)
# send duplicate messages to the spam box (INBOX.spam)
#
dupmailbox: spam

# Don't accept messages with duplicate bodies.  This can be
# useful to eliminate multiple copies of spam that isn't detected
# by anti-spam software.
nodupbody: True

# set lastdupbody True to keep only the last copy of messages
# with duplicate bodies.  This is useful for things like periodic
# maintenance reports where it's useful to know when the last
# message came in.  This overrides the nodupbody setting.
lastdupbody: True

# Set for shared folders.  If this is True, it needs to include a
# path line with the *FULL PATH* to the directory, and must be
# included for all sub-folders of that directory
shared: False

# This is really a system level parameter that determines the
# hostname part of the file name.  Set it to False to use full
# host names.
shorthostname: True

# The default path to the main (INBOX) Maildir
# mailbox = ~/Maildir

# This is the prefix for all subfolders.  Generally this is used
# to allow shortcuts (e.g. spam instead of INBOX.spam)
folderprefix = INBOX

# Set ``archive'' to ``year'' or ``month'' in a folder to
# automatically put messages in subfolders by year or year.month.
# archive = ''

# cronarchive is used to allow periodic cron jobs to archive
# folders, and is the same as archive, (e.g. year or month)

cronarchive =

# Set ``taggedboxes'' to True to automatically put tagged mail messages
# into separate boxes.  That is mail to user+tag@example.com will
# go into the tag folder in their main mailbox.  This is for
# processing by the deliver.post process.

taggedboxes = True

#
# Check incoming mail using spamassassin's spamd daemon.
# the sa_host and sa_port parameters may be used to change the
# default host and port respectively.
#
sa_check	= True
sa_host		= localhost
sa_port		= 783
#
# The sa_levels option sets cutoff levels for spam scores.  Mail
# with Spamassassin scores greater than or equal to the score is
# put the folder.  Valid entries are score, folder pairs with no
# commas or other special characters, and may be put one per line
# with leading white space.

# sa_levels: 7.00 DROP
sa_levels: 14.00 DROP
# sa_levels: 200.00 DROP

# Set this to point to a file containing headers, patterns, and
# folders for automatic mail sorting.  This should be overridden in any
# mailboxes that don't want further looking at mailbox rules (e.g. things
# like support, spam, security which may be hit with tagged addresses.

mailrules: ~/Maildir.rules

# These variables are used when forwarding messages via the mail
# rules.

# smtphost = localhost
# smtpport = 25
myorigin = celestial.com

# Default retry time for mailbox reading in seconds

xelmretry:	60

# The next two options are the names of folders used to drop
# messages that are either spam that was missed by the filters or
# non-spam messages that were identified as spam.

junkfolder:		spam.missed
falsepositive:	spam.fallpositive

# spamassassin no ***SPAM*** prefix
sa_subject_prefix:

# These map folder names which is useful for things like mapping tagged
# addresses to real folders (e.g. user+pp@example.com -> vendor.paypal
# folder.
#
[foldermaps]
inbox = general
# clamav tags
virus = postmaster
banned = postmaster
header = postmaster

# This maps folders to shared mailboxes.  The shared Maildir
# folders will have the prefix set to the key (e.g. the folder
# name.
#
[maildirs]
public:		~/MaildirShared
spamtrap:	~/MaildirSpamtrap
archivebill:	~/MaildirArchive
incoming:	~/MaildirIncoming

[INBOX]
# This is the default INBOX
dupsok = False
# save only the most recent copy of duplicate message bodies
lastdupbody = True

[alert]
sa_check: False
cronarchive = month
dupsok	= True
mboxpatterns: '' # suppress additional rules checking
nodupbody: False

[bulk]
# keep a year's traffic in the top bulk folder
cronarchive: year
xelmretry: 1800

[junkfax]
# keep a month's traffic in the top junkfax folder
cronarchive: month
# xelmretry: 1800

[customer]
cronarchive: year
lastdupbody = True

[fax]
cronarchive: month
# Fax notifications

[general]
cronarchive: year
# This is really the default INBOX
dupsok = False
# save only the most recent copy of duplicate message bodies
lastdupbody = True
xelmretry: 600

[postmaster]
sa_check = False
dupsok	= True
mboxpatterns: '' # suppress additional rules checking
nodupbody: False
lastdupbody: False

[support]
#
# We want to keep the most recent copy of messages with duplicate
# bodies
#
lastdupbody: True

# Don't check against mailbox rules
mboxpatterns: ''
nodupbody: False
# Don't check support e-mail for spam as it may well be a spam
# report.
sa_check = False

[security]
cronarchive: month
sa_check: False
# archive = month
dupsok	= True
mboxpatterns: '' # suppress additional rules checking
nodupbody: False

[spam]
sa_check: False
# take all duplicates
dupsok: True
mboxpatterns: False
nodupbody: False

[sugm]
# News and Seattle Unix Group
xelmretry: 600

[spam.missed]
sa_check: False
vacation_allow: False
# take all duplicates
dupsok: True
mailrules: ''
nodupbody: False

[spam.falsepositive]
sa_check: False
vacation_allow: False
# take all duplicates
dupsok: True
mailrules: ''
nodupbody: False

[vendors]
sa_check: False
vacation_allow: False
# take all duplicates
dupsok: True
mailrules: ''
nodupbody: False

[Trash]
purgetime = 1d

cronarchive

This option controls automatic archiving of messages into subfolders. The usual options are year and month which create subfolders by year and month respectively. I use year for top level folders of general use such as my ``bulk'' folder which contains mailing list traffic, and my ``general'' folder which is miscellaneous e-mail that doesn't fit in other categories. I use ``month'' for things like my ``security'' folder which is fairly high volume (over 15,000 messages per month).

taggedboxes

Setting this to ``True'' causes the system to recognize ``tagged'' e-mail addresses such as user+vendor@example.com where the user is the user name, and ``vendor'' is the tag. This would route this message to the vendor folder.

Spam Options

These options turn spam checking on and off for individual folders, and may be used to select spam into different folders based on the spam score.

sa_check

This is either ``True'' or ``False''. Setting it to False turns off spam checking for the folder.

sa_host and sa_port

Don't mess with these unless you know what you're doing.

sa_levels

This sets one or more pairs of values, a score, and a folder. In the example above, ``sa_levels: 14.00 DROP'' has all spam with a level about 14.00 to be silently dropped. Something like this would create additional spam folders. Spam with scores below 10.00 would go in the spam folder, between 10.00 and 15.00 in the spam.high folder, between 15.00 and 20.00 in spam.horrible, and anything above 20.00 would be dropped.


sa_levels: 10.00 spam.high 15.00 spam.horrible 20.00 DROP

junkfolder and falsepositive

These should be left alone.

sa_subject_prefix

This may be used to set a prefix that will be added to the Subject of messages identified as spam. Generally it's best to leave this empty as anything in the spam folder will be spam.


Powered by Plone CMS, the Open Source Content Management System

This site conforms to the following standards: