Apache SpamAssassin™ is an email utility that examines incoming email and tests for spam characteristics. It uses Bayesian spam filtering and network tests to screen incoming email. This results in an overall score that Apache SpamAssassin uses to determine whether it should discard a message.
Note: If you experience trouble when you use BoxTrapper and Apache SpamAssassin together, contact your web hosting provider for more information about your server's configuration.
Enable or disable Apache SpamAssassin
The Apache SpamAssassin interface displays the current status of the feature.
- To enable Apache SpamAssassin, click Enable Apache SpamAssassin.
- To disable Apache SpamAssassin, click Disable Apache SpamAssassin.
This feature automatically deletes messages that meet or exceed the score limit.
- To enable this feature, select the desired minimum spam score and click Auto-Delete Spam. This setting defaults to 5.
- To disable this feature, click Disable Auto-Delete Spam.
Notes: If you enable this feature and a message that is not spam meets or exceed the defined score, you may lose that email. Make certain to properly configureApache SpamAssassin before you use this feature.
Enable Spam Box
- Your hosting provider may need to enable this feature. If you want to redirect spam from your email inbox, and this option is not available, create aspam email filter.
- We recommend that you enable this feature.
Click Enable Spam Box to cause Exim to create a
spam folder the next time that you receive spam mail. Exim sends all of the mail that Apache SpamAssassin marks as spam to this folder. This feature preserves mail that the system may mistakenly classify as spam mail.
After you enable this feature, click Clear Spam Box to delete the messages in the Spam Box.
Warning: If you check your mail through a POP3 client, access and empty your spam box with the username
firstname.lastname@example.org/spam and your email account password. If you do not do this frequently, spam may accumulate in the Spam Box and cause you to reach your email account quota.
- The above format is only functional to access the Spam Box. You cannot use this method to access other folders on your account. Some webmail clients may require you to take additional steps.
- If you are unsure of whether you use POP3 or IMAP to receive mail, you can find this information in your email application's Preferences interface.
Apache SpamAssassin™ Configuration
When you click Configure Apache SpamAssassin™, you will see the option to filter addresses automatically.
- If you need to add more than five addresses to the blacklist, fill in the first five text boxes and click Save. Additional text boxes will appear.
- Click Save to store the configuration changes.
- For more information, visit the Apache SpamAssassin documentation.
When you add the addresses to the blacklist or whitelist, use
* as a wildcard to represent multiple characters and
? to represent a single-character wildcard. The following examples demonstrate how to properly use wildcards in the blacklist:
email@example.com— Blacklists or whitelists a single email address.
*@example.com— Blacklists or whitelists all of the addresses at
?firstname.lastname@example.org— Blacklists or whitelists a single character in an address at
email@example.com, but not
Apache SpamAssassin may incorrectly tag some mail as non-spam messages. If these messages often come from specific addresses, you can blacklist them to ensure that Apache SpamAssassin tags their messages correctly.
To do this, enter the address in one of the blacklist_from text boxes.
System administrators who wish to blacklist email addresses on multiple accounts should use the Exim System Filter File.
Apache SpamAssassin examines every email message for spam characteristics and assigns it an overall score.
Use the required_score text box to set the required score to mark a message as spam. The default setting is
5.0, which is aggressive. It is suitable for a single user, but ISPs should set the default to be more lenient (for example,
The following table indicates when Apache SpamAssassin uses each score.
For example, you could enter the following individual test score:
This example sets the scores that Apache SpamAssassin assigns to a message with an invalid date in its header.
- If you only list one number, the test uses that score.
- Set a score to
0to disable the test.
In the example above,
3.2 is the first score,
3.3 is the second,
2.5 is the third, and
2.1 is the fourth. If you enter four numbers, as in the example, the score that Apache SpamAssassin uses depends on the Bayes and network tests that are enabled in your installation of Apache SpamAssassin.
Add email addresses that Apache SpamAssasin often blocks, but from which you wish to receive mail, to the Apache SpamAssasin whitelist.
To do this, enter the address in one of the whitelist_from text boxes.