[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

10. Using Anubis to Process Incoming Mail

Historically Anubis was designed to process outgoing mail. Support for processing incoming mail was added in version 4.1.

To process incoming mail, Anubis must be started as mail delivery agent from your MTA configuration file. The invocation line must contain `--mode=mda' option, that tells Anubis to act in mail delivery mode. In this mode, Anubis receives the message from standard input, processes it using configuration file sections named incoming-mail-rule (see section incoming-mail-rule) and finally calls local mailer to actually deliver the modified message. The local mailer must be given using `--local-mta' option.

Let's summarize the special features of mail delivery mode:

  1. The mode is triggered by `--mode=mda' in the command line. It cannot be specified in configuration file.
  2. Anubis uses local mailer to actually deliver messages. The invocation line of the local mailer must be given via `--local-mta' command line option. The `local-mta' settings (if any) (see section Basic Settings) are ignored.

    The local mailer invocation line can contain meta-variables %sender and %recipient, which will be replaced by the actual sender and recipient email addresses before starting the mailer.

  3. A special option `--from' may be used in Anubis command line. This option sets sender email address (see %sender meta variable above). It implies `--mode=mda'. If the option is not given, GNU Anubis will deduce sender address from UNIX `From ' header or, if it is not present, from the value of From SMTP header.
  4. In MDA mode, Anubis takes recipient email addresses from the command line.
  5. Anubis uses a separate rule section for processing incoming mails. The default section name is `INCOMING'. It may be overridden in system configuration file using `incoming-mail-rule' (see section incoming-mail-rule).

The following discussion explains how to configure Anubis in MDA mode with different mail transport agents.

[ < ] [ > ]   [ << ] [ Up ] [ >> ]

This document was generated on May, 24 2014 using texi2html 1.76.