Postfix

There are three ways to integrate with Postfix

Milter - Forward to MailArchiva's embedded milter server (see http://www.postfix.org/MILTER_README.html for description of Postfix's Milter capabilities)
SMTP - (Always BCC) Configure Postfix to send copies of all mails to MailArchiva directly via SMTP
 

Milter Approach

MailArchiva has an embedded Milter server that by default listens on port 8092. The instructions below configure Postfix to forward milter traffic to MailArchiva's milter server. The use of the milter protocol is not ideal, since it if the archive server goes down, delivery will be affected. Generally, the use of the SMTP protocol for archiving purposes is preferred.

Make sure you are using Postfix 2.4.6 or greater. 

MailArchiva Configuration

1. Click Configuration->Listeners.
2. Select Milter Listener in the drop down and then click the New Listener button.
3. Check "Listen for incoming Sendmail/Postfix requests"
4. Leave the Sendmail Milter port as 8092
5. Click Save

Postfix Configuration

1. Add the following to Postfix’s main.cf file:

(if MailArchiva is running on a remote server, replace 127.0.0.1 with the ip address of the server where MailArchiva is running)

2. Restart postfix

Milter Default Action Options
 

• milter_default_action = tempfail: mail is not archived when MailArchiva becomes unavailable.  Mail is not delivered to the recipient(s).  The remote client retries until the MILTER becomes available or until the mail is too old.
• milter_default_action = accept: mail is not archived when MailArchiva is unavailable.  Mail is delivered to the recipient(s).
• milter_default_action = quarantine: mail is not archived when MailArchiva is unavailable.  Mail is stored in the "hold" queue.

Spam Filtering

Note: If you want Spamassasin to filter out the SPAM before it hits MailArchiva, configure Spamassassin as a milter (Google the topic for info on how to do this)

Then, specify your milter configuraiton as follows:
 

SMTP Approach

MailArchiva has an embedded SMTP server that by default listens on port 8091. 

MailArchiva Configuration

1. Login to the MailArchiva web console (by default accessible from http://localhost:8090)
2. Click Configuration->Listeners.
3. Select SMTP Listener in the drop down and then click the New Listener button.
4. Check "Listen for incoming Exchange/SMTP requests"
5. Set the Exchange port to 25
6. Click Save
    

After performing the above steps, verify there is an open line of communications by telnetting to the MailArchiva server on port 25 from the mail server. If the MailArchiva SMTP signature header is not returned, ensure that a firewall is not blocking the communications and that there is no other application binding to port 25 on the MailArchiva server.

Postfix Configuration