SpamAssassin is an email utility that attempts to filter spam by examining incoming email and testing for spam characteristics. It uses Bayesian spam filtering and network testing to screen incoming email. This results in an overall score. If an incoming message reaches a predefined score, the message is discarded.
This score can be set under the Filters heading. The default setting is 5.
To enable SpamAssassin:
Simply click the Enable SpamAssassin button on the SpamAssassin home screen.
Note: It is possible to disable SpamAssassin by returning to the SpamAssassin page and clicking Disable SpamAssassin.
Automatically Delete Spam
This function automatically deletes messages that meet or exceed the score limit. Activate this function by clicking the Auto-Delete Spam button under the Filters heading.
Click the Disable Auto-Delete Spam button to disable this feature.
Note: Enabling this feature could cause you to lose email that is not spam, if a message meets or exceeds the defined score. Make sure SpamAssassin is configured properly for your account before using this feature.
Enable the Spam Box
Enabling the spam box will create an additional folder, named “spam,” where spam mail will be sent. This can be useful in preserving mail that may have mistakenly been filtered by SpamAssassin. It is recommended that you enable this feature.
This feature also comes with a Clear Spam Box function that will delete the messages in the spam box.
It is possible to disable the spam box by returning to the SpamAssassin page and clicking Disable Spam Box.
Warning: If you check your mail via a POP3 client, you must access and empty your spam box using the username firstname.lastname@example.org/spam and your email account password. Otherwise, spam may accumulate in the spam box and cause you to reach your email account quota.
- Only the spam box may be accessed using the above address format; no other folders on your account are accessible in this way.
- While this is not an issue for IMAP and webmail users, all users should periodically check and delete the contents of the spam box.
- If you are unsure whether you use POP3 or IMAP to receive mail, you may be able to find this information on your email application's Preferences screen.
When you click Configure SpamAssassin, you can add email addresses that should be filtered automatically by typing the address into the blacklist_from box. A whitelist can be created in the same way at the bottom of the page. It is also possible to specify scores that SpamAssassin should use for each particular test.
Set Required Spam Score
SpamAssassin examines every email message for spam characteristics, then assigns it an overall score. Enter the score required for a message to be considered spam.
5.0 is the default setting, and is aggressive. It would be suitable for a single user, but an ISP should set the default to be more lenient (8.0 or 10.0).
Add Addresses to the Blacklist
You can add addresses to the SpamAssasin blacklist to block the receipt of emails from those addresses.
When you add the addresses to the blacklist, 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 a single email address.
- *@example.com — Blacklists all the addresses at example.com.
- ?firstname.lastname@example.org — For example, User@example.com would be blacklisted, but AUser@example.com would not be blacklisted.
System Administrators who wish to block the receipt of emails from these addresses on multiple accounts should use the the Exim System Filter File.
Set Individual Test Scores
You can precisely tailor SpamAssassin for your server by assigning scores to individual tests. SpamAssassin uses hundreds of tests; please see the SpamAssassin documentation at http://spamassassin.apache.org/tests.html for more information. You will need to know which version of SpamAssassin is running on your server. To check your version of SpamAssassin, execute the following line of code on your server:
# perl -MMail::SpamAssassin -e 'print $Mail::SpamAssassin::VERSION."\n";'
You can enter individual test scores in the following format:
- “score” “TEST_NAME” “1 to 4 positive or negative numbers”
- score INVALID_DATE 3.2 3.3 2.5 2.1
- If only one number is listed, that score is always used for the test.
- Setting a score to 0 will disable the test.
- The first score is used when both Bayes and network tests are disabled.
- The second score is used when Bayes is disabled, but network tests are enabled.
- The third score is used when Bayes is enabled and network tests are disabled.
- The fourth score is used when Bayes is enabled and network tests are enabled.
Add Addresses to the Whitelist
Enter addresses whose email is often blocked, but from whom you wish to receive email.
You may use * as a wildcard for multiple characters, or ? as a single-character wildcard.
- email@example.com — Whitelists a single email address.
- *@example.com — Whitelists all the email addresses at example.com.
- ?firstname.lastname@example.org — For example, User@example.com would be added to the whitelist while AUser@example.com would not be added.
By default, 5 text boxes appear, allowing you to add 5 addresses. To add more than 5 addresses:
- Fill in the first 5 text boxes.
- Click Save.
- Click Save to store the configuration changes.
- A whitelisted address is automatically allowed past the filter.
- A blacklisted address will automatically be filtered by SpamAssassin.
- More details about configuring SpamAssassin can be found at http://spamassassin.apache.org/.
A Note for System Administrators
If you do not have access to a WHM interface, the following information does not specifically pertain to you. If you are experiencing trouble using BoxTrapper and SpamAssassin together, you should contact your web hosting provider for more information about how your server is configured.
BoxTrapper and SpamAssassin will only work together if the following option in WHM's Exim Configuration interface ( Main >> Service Configuration >> Exim Configuration Editor) remains disabled:
** Old Style Spam System [?]
DEPRECATED: Use legacy transport based SpamAssassin™ system instead of the new ACL style one (not recommended, slow).