SpamAssassin Integration with Postfix, using Amavis
This is just a summary of the following websites. Go there for more detailed information.
This document describes the configuration for sitewide use of SpamAssassin with Amavis and Razor. The distribution used is SuSE Linux 9.0. If you use something else, some options may be different. For example Amavis may run as user amavis, not vscan and the path to the Amavis spool directory may be
/var/amavis not /var/spool/amavis
This section describes how to configure Postfix to use amavisd-new as an after-queue content filter (see the FILTER_README file that comes with your version of Postfix).
First, a few services must be defined in master.cf. The first service will setup an extra SMTP listener on a different port (10025 in this example). It will be used for the reinjection of mail back into Postfix. By unsetting the content_filter parameter, content filtering will be disabled for incoming mail on this port. This avoids loops.
The second service added is not strictly necessary, but is a good idea to have. It defines a service to use when sending the mail into amavisd-new. The "2" in the seventh column is the maximum number of processes of this type. Do not set this number too high, and make sure it is equal to the maximum number of amavisd-new processes (set in amavis.conf).
Finally, we must configure Postfix to actually use our content filter. This is done with the content_filter parameter which we add to main.cf. We configure Postfix to use our newly defined smtp-amavis service and to connect to a certain host and certain port. Obviously, the port set here must be the port amavisd-new is listening to.
In this case, amavisd-new is running on the same host as Postfix, but it can be any host. With brackets surrounding the hostname, MX lookups of the hostname are suppressed. They are also necessary when specifying bare IP addresses instead of hostnames. MX records in DNS can be used to create simple load-balancing and fallback configurations.
This simple setup will cause address rewriting both before and after the content filter. For most configurations this is not only unnecessary, but will cause duplicate mail to be delivered in configurations with virtual aliases of the form a -> a,b. Virtual rewriting must be turned off either before or after the content filter. How this is done is, again, documented in Postfix's FILTER_README file doc.
Amavis is just used for spam detection, not virus protection. See the options below.
Change the following options:
- $mydomain = 'example.com'
Change 'example.com' to 'domain1.com'
- @bypass_virus_checks_acl . . . .
Change to @bypass_virus_checks_acl = qw( . );
We only want spam protection and no virus scanning, so this will disable virus scanning for all
- $mailfrom_notify_spamadmin . . .
"spam.police@$mydomain"; to "firstname.lastname@example.org";
- #$spam_quarantine_to = 'spam-quarantine';
and insert a # symbol at the beginning of that line On the very next line, you'll see:
#$spam_quarantine_to = "spam-quarantine@$mydomain";
Here, remove the leading # symbol. (And make sure you have a mailbox for this address on a destination server -
This is where you will review quarantined emails, and will forward on any "false positives" to the proper recipients.)
*Alternative:* Instead of delivering the spam to a mailbox on the internal server, drop it into a folder right on the spamfilter. To do that, comment out the "spam_quarantine_to" line above that references the email address, and instead select and indicate a folder name for the value "spam_quarantine_to". (Read the comments in this area of amavisd.conf for more info.)
See http://www.ijs.si/software/amavisd/#faq-spam for details.
- $sa_local_tests_only = 0;
If you want to use Razor, this has to be set to 0.
- $sa_tag_level_deflt = -999;
The number of hits needed to update the mail headers.
With a value of -999 all headers will be updatedt with X_Spam_Flag, X_Spam_Level and X_Spam_Status
- $sa_tag2_level_deflt = 5.0;
The number of hits required to set X_Spam_Flag to Yes.
- $sa_spam_subject_tag = '***SPAM*** ';
Remove the # if you want ***SPAM*** to be added to the subject of spam mails.
- SpamAssassin configuration*
Go to /etc/mail/spamassassin and edit local.cf. My file looks like this.
Be sure to doublecheck this options with amavisd.conf. If one of these options is in amavisd.conf, the one in local.cf will not be used.
Amavis expects to see spamassassin's user_prefs file in /var/spool/amavis/.spamassassin but that directory and that file do not exist. Spamassassin's Bayes data is also stored there.
cp -r /root/.spamassassin /var/spool/amavis
This will create it (and copy user_prefs to that directory at the same time).
chown -R vscan:vscan /var/spool/amavis/.spamassassin
Give amavis ownership
If you run spamassassin --lint -D from a command line you will notice that
spamassassin looks for config files in /root/.spamassassin and razor files in /root/.razor
This is misleading and confusing because
that is not where it looks when it runs under amavis.
You can create symbolic links to help make the command line debug look cleaner.
Also, it will not find any Bayes files in /root/.spamassassin so the
symbolic links will help there too.
ln -s /var/spool/amavis/.spamassassin/user_prefs user_prefs
ln -s /var/spool/amavis/.spamassassin/bayes_seen bayes_seen
ln -s /var/spool/amavis/.spamassassin/bayes_toks bayes_toks
- Razor configuration*
Open port 2703 in your firewall.
This creates sym-links
razor-admin -d -create
Creates files in /root/.razor and shows debugging info.
Creates a random user name and password.
Necessary for data access to Razor2 servers.
Refreshes the list of razor servers
Razor has to be patched to run under SpamAssassin.
Browse to http://www.ijs.si/software/amavisd/Razor2.patch-quinlan
use Save Page As and save in:
patch -p0 < Razor2.patch-quinlan
razorhome = /var/spool/amavis/.razor
Change the debuglevel from 3 to 0 or the log file will eventually
consume all disk space.
Save the file. We are going to copy Razor to it's new home in a moment.
Seems Amavis is not happy unless Razor is in that directory and it owns it.
cp -r /root/.razor /var/spool/amavis
This copies the stuff we need to where we need it.
razor-admin -d -create -home=/var/spool/amavis/.razor
This tries to force Razor to live there.
chown -R vscan:vscan /var/spool/amavis/.razor
Now amavis owns it.
This forces SpamAssassin to find the file here.