Knowledgebase

You just want to run a website and make the most of your business’s email address, but managing spam is starting to feel like a full-time job. Sound familiar? It seems that no matter what we try, the world’s ‘spam artists’ find new ways to annoy us.

If you have never managed your own email before, the sheer volume of spam may shock you. That’s why cPanel comes pre-installed with Spam Filters powered by Apache SpamAssassin, one of the most powerful open source email filtering systems available. Use this guide to setup your server’s spam prevention to help cut down on the amount of spam you have to deal with!

• How SpamAssassin Works
  • How the Point System Works
• Enabling and Disabling SpamAssassin in cPanel
  • How to Enable SpamAssassin
  • How to Disable SpamAssassin
• Optimizing SpamAssassin for Your Account
  • How SpamAssassin Scores Spam Messages
  • How to Modify the Spam Threshold Score
  • Choosing a Spam Threshold Score
  • The Spam Box
  • Enable/Disable the Auto-Delete Feature
  • Auto-Delete Spam Threshold Score
  • SpamAssassin is Enabled and Still Getting Spam
  • Using Filters to Organize Spam
  • How to Manage Blacklist Filters
  • How to Manage Whitelist Filters

• How to Enable/Disable SpamAssassin in WHM
• How to Locate High Levels of SpamAssassin Activity
  • Can SpamAssassin Slow Down a Server?
  • When Should I Review SpamAssassin Logs?
  • Locate Users with the Highest SpamAssassin Executions

• Why Does SpamAssassin Label my Email as Spam?
  • How Does SpamAssassin Determine that Email is Spam?
  • How to Lower Your SpamAssassin Score
  • Understanding X-Spam Scores
• WPS Central: Using SpamAssassin
  • Adjusting the Spam Threshold Score
  • Whitelisting Emails

How SpamAssassin Works

Note: SpamAssassin is the software that powers cPanel’s spam filtering system. Newer versions of cPanel will list these resources under Spam Filters, but older versions on some servers may keep everything under SpamAssassin. Don’t worry — the resources are the same no matter what the icon is called! In WebHost Manager (WHM), different anti-spam settings are listed alongside related server functions.

cPanel’s Spam Filters powered by SpamAssassin are not an all-or-nothing email filter, as some other spam prevention tools are. Instead, they determine whether an email is spam as soon as it hits the server. SpamAssassin works on the back end of your email server and has 10 different levels of settings to catch spam. When enabled by default, your filters will be set to 5. This is mid-range — but what exactly does that mean?

How the Point System Works

SpamAssassin uses a points-based system called “hits” to label spam. When it finds particular characteristics in an email it assigns a point value. These ‘characteristics’ can include everything from words and topics commonly found in spam emails, to malicious code, and even custom values you set yourself. If the email exceeds the maximum point value you set, the email is flagged as spam.

The lower the score you set, the more email will be caught as spam. For example, a setting of 1 means that only one hit needs to be flagged against an email for it to be considered spam. If you set the score higher, more hits will be required on an email for it to be labeled as spam. So, the lower the score, the more emails should be flagged as spam.

We suggest testing the different settings prior to using a higher setting.

Enabling and Disabling SpamAssassin in cPanel

How to Enable SpamAssassin

1. Log into cPanel.
   
   
    
   NOTICE: The toggle should change to blue and a green success message will appear, indicating: “Apache SpamAssassin has been enabled.”

How to Disable SpamAssassin

1. Log into cPanel.
2. Under the Email section, click on the Spam Filters icon.
3. Click on the toggle switch that appears before Process New Emails and Mark them as Spam.
   
   
   NOTICE: The toggle should change to grey and a green success message will appear, indicating: “Apache SpamAssassin has been disabled.”

Optimizing SpamAssassin for Your Account

How SpamAssassin Scores Spam Messages

With spam comprising almost 80% of all emails sent across the planet, it is definitely important to try and filter them out as best you can. With a tool like SpamAssassin, each email will be evaluated against a score standard and either allowed to pass to your mailbox or flagged as spam and dealt with accordingly.

There are many different factors that SpamAssassin uses while trying to determine if a message is possibly spam or not. If you review our guide on why does SpamAssassin label my email as spam that should give you a good understanding of what it’s looking for when scoring a message.

You can also take a look at the long list of SpamAssassin tests performed in v3.3.x for the complete list along with scores of all the various tests SpamAssassin runs on your messages.

How to Modify the Spam Threshold Score

The Spam Threshold Score is the limit that can be set to identify spam messages in your email account(s). When SpamAssassin is enabled, it assigns a score to each email based on how likely it is to be spam. With a range of 0-10, the default setting for SpamAssassin is 5, which is right in the middle. If an email is given a score above the threshold, SpamAssassin will modify the header of that email to identify it as spam. The email header can then be used to filter spam away from your inbox, according to the settings configured in the Spam Filters plugin for cPanel. In this guide, you can learn how to modify the Spam Threshold Score.

Spam Threshold Score

1. Log into cPanel.
2. Under the Email section, click on the Spam Filters icon.
3. Under the toggle switch labeled: Process New Emails and Mark them as Spam, there is a brief description of how SpamAssassin works. Click on the link at the end, Spam Threshold Score.
4. Select a value from the Spam Threshold Score (required_score) drop-down menu.

   NOTE: The lower the Spam Threshold Score, the more strict the filter will be, resulting in the possibility of less spam appearing in your inbox. However, this may also cause more legitimate emails to be identified as spam (and possibly filtered away from your inbox).

   On the contrary, the higher the Spam Threshold Score, the less strict the filter will be, resulting in the possibility of fewer emails being falsely identified as spam. However, this may also cause more spam to appear in your inbox.

   The best way to determine which Spam Score is optimal for your email activity is to monitor the behavior closely while experimenting with various Spam Threshold Scores. For more assistance with this, please see below for a look at how to choose an effective spam threshold score.

5. Finally, click the Update Scoring Options button to save your new Spam Threshold Score.

Choosing a Spam Threshold Score

The Spam Threshold Score plays an important role in classifying emails as legitimate or spam messages. Unfortunately, one size does not fit all when it comes to setting the optimal value for classifying spam. The best way to find the most effective threshold score is through trial and error.

First, you should enable the Spam Box and disable the auto-delete features in the Spam Filters settings. This will filter emails that exceed the threshold score to a dedicated folder (for you to further review) rather than automatically deleting them. This also prevents legitimate emails from being automatically deleted if the threshold score is too strict.

Once that is done, you can proceed to set the Spam Threshold Score. At first, you can try to use the default value (5). With these settings in place, you should monitor the spam box and inbox closely for a few days to a week (depending on the number of emails you receive). If you see more spam emails being sent to your inbox, you should change your threshold score to a lower value (to be more strict). If you see more legitimate emails being sent to your spam box, you should change the threshold score to a higher value (to be more lenient).

Although taking an active approach to controlling the amount of spam you receive may seem daunting, it can be as simple as trial and error. The suggestions above will help to make it is easy to find that Goldilocks, “just right” setting though.

The Spam Box

The Spam Box is a great feature that can help mitigate the number of spam emails that appear in your inbox. By enabling the spam box and setting an appropriate Spam Threshold Score you can filter potential spam emails to their own folder. Along with the added benefit of reducing the number of spam emails in your inbox, you will also gain the ability to review the emails that are being classified as spam prior to deletion. In the event legitimate emails are falsely identified as spam, you can move them to your inbox rather than having them automatically deleted and lost forever.

Enable or Disable the Spam Box

1. Log into cPanel.
2. Click on the Spam Filters icon, under the Email section.
3. Click on the Move New Spam to a Separate Folder (Spam Box) toggle.
   
   The toggle should change to blue and a green success message will appear, indicating: “Success: Spam Box has been enabled.”
4. To disable Spam Box, simply click the same toggle.
   
   The toggle should change to grey and a green success message will appear, indicating: “Success: Spam Box has been disabled.”

Enable/Disable the Auto-Delete Feature

Once you have fine-tuned your Spam Threshold Score, you can turn on the Auto-Delete feature. This feature will automatically delete email messages assigned a spam score higher than your configured value. Here’s how to enable/disable the Auto-Delete feature from within the Spam Filters interface in cPanel.

1. Log into cPanel.
2. Click on the Spam Filters icon under the Email section.
3. Click on the Automatically Delete New Spam (Auto-Delete) toggle.
   
   The toggle should change to blue and a green success message will appear, indicating: “Spam Auto-Delete has been enabled.”
4. To disable Auto-Delete, simply click the same toggle.
   
   The toggle should change to grey and a green success message will appear, indicating: “Spam Auto-Delete has been disabled.”

Auto-Delete Spam Threshold Score

If the auto-delete feature is enabled in your Spam Filters settings, you can configure a separate Spam Threshold Score. If an email exceeds this score, the message will be automatically deleted.

1. Log into cPanel.
2. Under the Email section, click on the Spam Filters icon.
3. Under the toggle switch labeled: Automatically Delete New Spam (Auto-Delete), click on Configure Auto-Delete Settings
4. In the Auto-Delete Threshold Score field, enter the numerical value that you would like.

   WARNING: Email messages that are assigned a Spam Score higher than the value you set will be automatically deleted. Those email messages will not be able to be recovered. We recommend utilizing the Spam Box feature for filtering out spam.

   IMPORTANT: You can not set this score below the current Spam Threshold Score.

5. Click on the Update Auto-Delete Score button to save your changes.

SpamAssassin is Enabled and Still Getting Spam

You can adjust your SpamAssassin score settings to be more aggressive, by lowering the required_score value required to be met before a message is flagged as spam.

You can also blacklist or whitelist an email address or domain in SpamAssassin. So if you have one particular domain or user that keeps sending you spam that is getting by SpamAssassin, you could add them to your blacklist to have their messages automatically flagged as spam. Alternatively if someone you want to always be able to email you is having their messages flagged as spam, you could add them to your SpamAssassin whitelist.

Another thing that you can do is to block certain IPs from sending you email, or you can use cPanel user level email filtering to block other types of messages that SpamAssassin seems to be missing.

Using Filters to Organize Spam

In order to maximize the true power of SpamAssassin, we recommend you set up a Filter/Message rule in your mail client. Emails that are determined to be spam are still delivered to your inbox. Spam will begin with the subject line “SPAM“. By setting up filters in your email client you can sort the mail and have all messages labeled as spam placed into its folder for review later. This will keep junk mail out of your inbox. To learn how to set up filters in various email clients, please visit our guide on setting up email filters.

Blacklisting/Whitelisting Email addresses in SpamAssassin

How to Manage Blacklist Filters

An influx of unsolicited emails can be quite irritating. However, you can utilize SpamAssassin to help fight against spam. In particular, you can add email addresses to the Blacklist so that Spam Filters will classify messages from them as spam. In this guide, you can learn how to manage the SpamAssassin Blacklist using the Spam Filters plugin for cPanel.

View Blacklist

1. Log into cPanel.
2. Click on the Spam Filters icon located in the Email section.
3. 

   Under the Additional Configurations (For Advanced Users) section, click on Show Additional Configurations to expand the section. NOTE: This section and its options will only appear when SpamAssassin is enabled.

4. From the Blacklist (Emails Never Allowed) section, click on the link labeled: Edit Spam Blacklist Settings.

    

Now that you are familiar with where you can view the Blacklist, adding email addresses to the list is just a few clicks away. Follow along with the steps in the next section to learn how to add an email address to the Blacklist of SpamAssassin.

Add Email Address

1. Log into cPanel and navigate to the Blacklist settings.
   
   
   
    
2. A blacklist_from field will appear for you to enter the email address into. Repeat Step 2 and 3 for each email address you would like to add.
    
3. Click the Update Blacklist (blacklist_from) button to save your changes.
    

Once you add email addresses to your Blacklist message from any of the email addresses listed within will be marked as spam by SpamAssassin. If you made an error or just want to remove an email address from the Blacklist, you can follow the steps in the section below.

Delete Email Address from Blacklist

1. Log into cPanel and navigate to the Blacklist settings.

2. Click on the icon to the right on the blacklist_from field that contains the email address you would like to remove.

   
   
    

3. Click the Update Blacklist (blacklist_from) button to save your changes.

How to Manage Whitelist Filters

If you are expecting an email that you (based on your Spam Filters settings) think may be mistaken for spam, you can add the email address to a Whitelist. This will ensure that the message is not classified as spam. Here’s how to view the Whitelist Settings along with how to add and delete email addresses to manage the SpamAssassin Whitelist.

View Whitelist

NOTE: This section and its options will only appear when SpamAssassin is enabled.

1. Log into cPanel.
2. Click on the Spam Filters icon located in the Email section.
3. Under the Additional Configurations (For Advanced Users) section, click on Show Additional Configurations to expand the section.
   
   
4. From the Whitelist (Emails Always Allowed) section, click on the link labeled: Edit Spam Whitelist Settings.
    

Now that you are familiar with where you can view the Whitelist, adding email addresses to the list is just a few clicks away. Follow along with the steps in the next section to learn how to add an email address to the Whitelist of SpamAssassin.

Add Email Address

1. Log into cPanel and navigate to the Whitelist settings.
2. Click on the Add A New “whitelist_from” Item link.
    
3. Click the Update Whitelist (whitelist_from) button to save your changes.

Once you add email addresses to your Whitelist you should successfully receive messages from the specified email address(es) to your inbox and they should not be marked as spam. If you made an error or just want to remove an email address from the Whitelist, you can follow the steps in the section below.

Delete Email Address from Whitelist

1. Log into cPanel and navigate to the Whitelist settings.
2. Click on the icon to the right on the whitelist_from field that contains the email address you would like to remove.
   
   
    
3. Click the Update Whitelist (whitelist_from) button to save your changes.
   
   
    

How to Enable/Disable SpamAssassin in WHM

SpamAssassin is the primary application used to detect and mark incoming or outgoing spam emails for your cPanel-based VPS or Dedicated server. In some cases you may prefer to have it disabled; this is not recommended unless you are using a different solution to reduce or mark spam. Be aware that SpamAssassin can only be enabled account-wide. It cannot be specific to a created cPanel account.

Enabling or disabling Spam Assassin requires that you have root access.

1. Login to the WHM.
2. Next, under the Server Configuration section click on Tweak Settings.
3. Tweak Settings has a lot of settings that you can change, but the one we’re looking for is under the MAIL tab. Click on the Mail tab to open the Mail options.
4. Scroll down in the Mail options until you find Enable Apache Spam Assassin spam filter. In the column at right, click on ON to enable, or OFF to disable Apache SpamAssassin.
5. When you have selected your choice, make sure that you click on the blue SAVE button at the bottom of the screen.

For more information on SpamAssassin, please see the official documentation.

How to Locate High Levels of SpamAssassin Activity

Can SpamAssassin Slow Down a Server?

While having SpamAssassin enabled for your users is a great option to help reduce the amount of spam that they deal with, if one particular user on your server is having an excessive amount of spam being processed for their account by SpamAssassin, it can lead to an increase in server demand.

If one user on your server is filling out their email address on every marketing list they come across or placing their email address in public places, at some point they could be receiving hundreds if not thousands of spam messages a day. Trying to have your server handle all of these could possibly be causing websites to run a bit slower, or delay other users trying to access their own email.

Please note that in order to follow the steps below, you’ll need to have root access to your VPS or dedicated server, so that you have access to the SpamAssassin logs.

When Should I Review SpamAssassin Logs?

If you happen to have a server load monitoring script setup to email you when the load on your server is spiking, or if you’ve reviewed our article on advanced server load monitoring and noticed that your server’s load is spiking at times, it would be good to review how often SpamAssassin is running for the accounts on your server.

Locate Users with the Highest SpamAssassin Executions

1. Login to your server via SSH as the root user.
2. Run the following command:
   
   Copy

   grep "SpamAssassin as" /var/log/exim_mainlog | awk -F"SpamAssassin as " '{print $2}' |
    awk '{print $1}' | sort | uniq -c | sort -n

    

   Code breakdown:

   grep “SpamAssassin as” /var/log/exim_mainlog	Locate mentions of SpamAssassin in the Exim mail log.
   awk -F”SpamAssassin as ” ‘{print $2}’ | awk ‘{print $1}’	Use the awk command with the Field seperator set to SpamAssassin as and print out the 2nd set of data following that. Then use awk again to only print out the first column of data (usernames).
   sort | uniq -c | sort -n	Sort the users by name, then uniquely count them, and finally sort them numerically by lowest to highest.

   You should get back something like:
   3783 unserna1
4339 userna6
5111 userna3
6588 userna5

   So now we know that the userna5 user has had SpamAssassin run on at least 6,588 emails.

3. Now we can take a look to see how often this user is having to have SpamAssassin scan messages with the following command:
   
   Copy

   grep "SpamAssassin as userna5" /var/log/exim_mainlog | sed -e 's#-# #g' -e 's#:# #g' |
    awk '{print $1"-"$2"-"$3,$4}' | uniq -c

   
   Code breakdown:

    

   grep “SpamAssassin as userna5” /var/log/exim_mainlog	Locate mentions of SpamAssassin in the Exim mail log for the user userna5 who had the highest amount of messages.
   sed -e ‘s#-# #g’ -e ‘s#:# #g’	Use the sed command to replace the hyphens – and the colons : that appear in the time stamps for the Exim mail log.
   awk ‘{print $1″-“$2”-“$3,$4}’	Use the awk command to print out the dates and just the hour column.
   uniq -c	Uniquely count up the time stamps, to see how many times SpamAssassin had to run each hour.

   You should get back something like:

   15 2013-01-16 00
25 2013-01-16 01
28 2013-01-16 02
31 2013-01-16 03
32 2013-01-16 04
26 2013-01-16 05
40 2013-01-16 06
70 2013-01-16 07
126 2013-01-16 08
117 2013-01-16 09
154 2013-01-16 10
183 2013-01-16 11
186 2013-01-16 12
155 2013-01-16 13
128 2013-01-16 14
145 2013-01-16 15
69 2013-01-16 16


   So that’s about 1,530 times that SpamAssassin had to run today for that one user, and you can see that during some hours it had to run as many as 186 times.

Why Does SpamAssassin Label my Email as Spam?

SpamAssassin is an application that tests email messages in order to see if they are defined as spam or not. It performs hundreds of tests on the messages and will assign a score to the message. This score can then be used by applications in order to filter emails so that only the relevant messages get through to the user. The following article briefly lists the tests run by SpamAssassin, explains how to lower your spam score and avoid false positives, and also aids in understanding the Spam scores.

This information should prove helpful to you if you are attempting to send an email to a server using SpamAssassin, or if your outbound email is being flagged as spam before it is sent. Other spam monitoring software will generally work along similar lines, but this can vary greatly from software to software and company to company. When in doubt, check directly with the relevant software’s documentation.

Please keep in mind that the classification of email as spam or not-spam is the responsibility of the recipient’s email administrator and based on their server’s anti-spam settings — you cannot ‘force’ your email through. Attempting to do so is likely to make a message seem even more like spam! Keeping your email from ‘sounding spammy’ is an ongoing process and you must constantly adjust to remain in compliance with industry best practices as they change and adapt.

How Does SpamAssassin Determine that Email is Spam?

SpamAssassin checks many variables within an email in order to determine the spam score. A user can also change the settings that SpamAssassin uses in order to determine if an email will score as spam or not. The number and complexity of the tests are so numerous that it can be difficult to understand why an email was given a particular score.

How to Lower Your SpamAssassin Score

The main thing is to make sure that your email does not fall into the definition of being spam. Here are some common issues and items that should be included in your email as defined by the CAN-SPAM Act of 2003 (section 5):

• Provide an indication that the email is an advertisement
• Include a type of return email address that allows the recipient to opt-out
• Email includes a clear notice that there is an option to opt-out
• Email is not sent after a recipient had sent notice that they wish to no longer receive the email
• Email contains a valid, physical address.

Your email should not include the following:

• False or misleading information in the header
• False or misleading information in the subject line

Other great sources of information that would help to keep your email from being labeled as spam or generating a false positive result include:

• Stop Blocking My Mail
• Frequently Asked Questions – SpamAssassin
• Avoiding False Positives

Another option to help in keeping your email from being labeled as spam is to use Domain Keys. The Domain Key is an e-mail authentication system that allows for incoming mail to be checked against the server it was sent from to verify that the mail has not been modified. This verifies that the email is coming from the listed sender and allows abusive messages to be tracked with more ease.

Understanding X-Spam Scores

Reading the X-Spam scores in the header of an email can definitely appear to be difficult. When you become familiar with the sections of the header, it becomes much easier to identify the portions that deal with SpamAssassin. Here are some of the headers that will give you information on how SpamAssassin judged the email:

WPS Central: Using SpamAssassin

SpamAssassin is present with WPS Central accounts through cPanel. The main difference is a few steps starting with the login to WPS Central.

Adjusting the Spam Threshold Score

The WPS Central dashboard manages emails through the cPanel interface.  Follow the steps below to change the Spam Threshold Score that helps to determine how emails are marked as spam.

1.  Log into WPS Central and click on Emails.
   
   
   
   
2.  Click on Manage Email Accounts.  This will open cPanel.
3.  Click on Spam Filters.
   
   
4. On the Spam Filters page, you will see the option labeled Process New Emails and Mark them as Spam.  In that section, there will be a link labeled Spam Threshold Score.  Click on this link.
   
   
5.  When you’re on the Adjust Spam Threshold Score you will see an explanation of how the score works and a drop-down menu to select a score.  Basically, the lower the score, the more emails will be flagged as spam.  A higher score means fewer emails will be marked as spam. Click on the drop-down menu to see the options that you can select.
   
   
   You will also have an option called Custom that allows you simply type in a number.  The default score is 5.  To make the spam filter less aggressive, choose 8, or select Custom and type in a number higher than 5.
6. Once you have made a change to the setting, click on the blue button labeled Update Scoring Options.  This will save your change and immediately affect the way your emails are being filtered.

Remember that the Spam Threshold Score only determines how emails are FLAGGED as spam.  Emails marked spam will not be deleted unless that option is set in the Spam Filters section.

Whitelisting Emails

The other way that you can stop incoming emails from being flagged as spam is to whitelist a domain or specific email address. Whitelisted domains or emails will not be filtered as spam.

1. Login to WPS Central, then click on Emails.
   
   
2. Click on Manage Email Accounts to get to the cPanel.
3. Click on Spam Filters.
   
4. When you’re on the Spam Filters page scroll to the bottom and click on Show Additional Configurations.
   
   
5. The first option that will appear in the additional configurations will be the option for whitelisting emails.  Click on the link labeled Edit Spam Whitelist Settings.