Knowledgebase

SpamAssassin is an open-source mail filter that identifies spam emails using a wide range of heuristic tests. This guide explains how to install SpamAssassin on Ubuntu 20.04 LTS or 21.04.

Prerequisites

• Deploy an Ubuntu cloud server instance at Rcs.
• Install Postfix mail transfer agent.
• Create a sudo user.
• Verify the server has outbound port 25 open.

1. Install SpamAssassin

1. Connect to your server with SSH.

2. Install SpamAssassin.

    $ sudo apt-get update
    $ sudo apt-get install spamassassin spamc -y

3. Add a SpamAssassin user and disable the login.

    $ sudo adduser spamd --disabled-login

2. Configure SpamAssassin

Assign the spamd user account to SpamAssassin and set the log and default home directories.

1. Edit the configuration settings.

    $ sudo nano /etc/default/spamassassin

2. Find the line:

    ENABLED=1

   Uncomment it by removing # and change the value from 1 to 0.

    ENABLED=0

3. Find the line:

    OPTIONS="--create-prefs --max-children 5 --helper-home-dir"

   Change it to include the SpamAssassin user account and log files directory.

    OPTIONS="--create-prefs --max-children 5 --username spamd --helper-home-dir /home/spamd/ -s /home/spamd/spamd.log"

4. Find the line:

    CRON=0

   Change the value from 0 to 1.

    CRON=1

5. Save and close the file.

6. Make a backup of the SpamAssassin local configuration file.

    $ sudo mv /etc/spamassassin/local.cf  /etc/spamassassin/local.cf.bk

7. Create a new SpamAssassin local configuration file.

    $ sudo nano /etc/spamassassin/local.cf 

8. Paste the information below to the file.

    rewrite_header Subject ***** SPAM _SCORE_ *****
    report_safe             0
    required_score          5.0
    use_bayes               1
    use_bayes_rules         1
    bayes_auto_learn        1
    skip_rbl_checks         0
    use_razor2              0
    use_dcc                 0
    use_pyzor               0
    ifplugin Mail::SpamAssassin::Plugin::Shortcircuit
    endif

9. Save and close the file.

3. Configure Postfix

1. Edit your Postfix configuration file.

    $ sudo nano /etc/postfix/master.cf

2. Locate these entries.

    smtp      inet  n       -       y       -       -       smtpd
    #smtp      inet  n       -       y       -       1       postscreen
    #smtpd     pass  -       -       y       -       -       smtpd
    #dnsblog   unix  -       -       y       -       0       dnsblog
    #tlsproxy  unix  -       -       y       -       0       tlsproxy
    submission inet n       -       y       -       -       smtpd

3. Below the smtp configuration, add a SpamAssassin content filter.

    smtp      inet  n       -       y       -       -       smtpd
   
    -o content_filter=spamassassin
    spamassassin unix -     n       n       -       -       pipe
    user=spamd argv=/usr/bin/spamc -f -e  
    /usr/sbin/sendmail -oi -f ${sender} ${recipient}

4. Save and close the file.

5. Restart Postfix and enable SpamAssassin to run at system startup.

    $ sudo systemctl restart postfix.service
    $ sudo systemctl enable spamassassin.service
    $ sudo systemctl start spamassassin.service 

More Information

To learn more about SpamAssassin, please see the official website.