Maildir Configuration

Configuring Debian for Maildir is not too hard, it's just hard to find out how. It's not the Debian default and there are no debconf prompts or alternatives that let you do it.

Be aware that when you change to using Maildir, some stuff will break. The mbox '/var/spool/mail' based delivery is so ingrained in Unix history that many utilities (like the "you have mail" notification) just cannot understand anything else. However, the speed and reliability benefits to IMAP usually make it worthwhile.

Using procmail for delivery

Both exim and postfix support using procmail for delivery "out of the box" on Debian. You can use procmail to put incoming mail into Maildir format by default. Another nice thing about this is it allows users to change the format of mail box(es) themselves by creating their own '~/.procmailrc', but make sure users are aware that if they do this, your IMAP and POP daemons will not see any non-Maildir format mailboxes.

First you need a global default procmailrc that will deliver email into users '~/Maildir'. Create a file '/etc/procmailrc' that contains::


Note that webmin's procmail module can be used to do this.

If procmail can not deliver to the DEFAULT location, the mail ends up in the location specified in the ORGMAIL variable (man procmail and #46598. Thus, a better '/etc/procmailrc' that copes with this fact would be:


Making Applications Maildir Aware

Next you need to ensure the various things that do mail stuff know you are using Maildir. This includes;

    export MAIL=~/Maildir

You can also edit '/etc/pam.d/*' so that '' is used to set MAIL, but this becomes a headache updating it every time packages update these config files, and the above two changes seem to cover everything anyway.

According to at least two bug reports (#189920 for SSH and #330420 for login) and a blog post about Debian lenny, PAM-aware applications must be configured through '/etc/pam.d/*' files (man pam_mail):

@@ -70,7 +70,7 @@ session    optional
 # in /etc/login.defs to make sure that removing a user 
 # also removes the user's mail spool file.
 # See comments in /etc/login.defs
-session    optional standard
+session    optional dir=~/Maildir standard
 # SELinux needs to intervene at login time to ensure that the process
 # starts in the proper default security context.

@@ -27,7 +27,7 @@ account    required
 session    optional # [1]
 # Print the status of the user's mailbox upon successful login.
-session    optional standard noenv # [1]
+session    optional dir=~/Maildir standard # [1]
 # Set up user limits from /etc/security/limits.conf.
 session    required

@@ -45,7 +45,7 @@ session       required readenv=1 envfile=/etc/default/locale
 # See comments in /etc/login.defs
 # "nopen" stands to avoid reporting new mail when su'ing to another user
-session    optional nopen
+session    optional dir=~/Maildir nopen
 # Sets up user limits, please uncomment and read /etc/security/limits.conf
 # to enable this functionality.

Nota bene: non-PAM-aware applications (like userdel) must still be configured in '/etc/login.defs', as explained here (#330420). However, there is no mention of QMAIL_DIR in userdel code and it is unclear how MAIL_DIR and/or MAIL_FILE should be set for Maildir support (yes, I am too lazy to test it right now).

This a solution for Maildir delivery that only requires changing the configuration for exim. I changed /etc/exim/exim.conf to deliver to Maildir directly with the following

This change goes in the transport section of exim.conf


  driver = appendfile
  group = mail
  mode = 0660
  mode_fail_narrower = false
  envelope_to_add = true
  #file = /var/spool/mail/${local_part}
  create_directory = true
  directory = ''home''${local_part}/Maildir

I'm missing the "You have new mail." Message when changing /etc/profile but not adding the dir=~Maildir parameter in /etc/pam.d/login and /etc/pam.d/ssh.

So instead of /etc/profile I changed the entries in both files as follows:


 session    optional standard noenv dir=~''Maildir''

/etc/pam.d/ssh (note the missing "noenv"):

 session    optional standard dir=~''Maildir''

-- ?ThomasBaluWalter

If there are mailboxes in mbox format, they can easily be transformed into Maildir format using mb2md (package mb2md). The command mb2md should be issued as the user, who transformes his mailbox.

mb2md -s /var/mail/foo -d ~/Maildir/

-- ?RalphPlawetzki

CategoryNetwork CategoryMail CategorySystemAdministration