Install MailScanner Front End (msfe) on cPanel Server

This article provides a guide for installing MailScanner Front End (msfe) on cPanel server.

What is MailScanner Front End (msfe)?

ConfigServer MailScanner Front-End is an exclusive plugin for cPanel that allows you to manage and configure MailScanner as well as offering additional features such as the MailControl viewer, SpamBox, and Digest emails.

Key Features include:

  • For cPanel dedicated servers or cPanel VPS servers – protects all domains, IP addresses and users on the server
  • Scan email for spam using SpamAssassin
  • Scan for viruses using ClamAV anti-virus scanner
  • Internal scanner for dangerous file attachments by filename and filetype
  • Scan for phishing attacks

Requirements to Install ConfigServer MailScanner Front End on cPanel Server

The following prerequisites are required to install MailScanner Front End on cPanel Server:

  • cPanel/WHM – latest versions fully supported
  • Supported OS’s for cPanel: Redhat v7, CentOS v7, Ubuntu v20.04 , CloudLinux v7/8, AlmaLinux v8/RockyLinux v8, AlmaLinux v9/RockyLinux v9 (See also: Install cPanel on Rocky Linux 9 Server)
  • ClamAV daemon process, for virus scanning
  • Minimum of 2 GB of RAM, preferably 3 GB. While we endeavour to configure MailScanner to be as efficient as possible, the application inevitably uses server resources. Due to this additional load, we recommend caution when installing MailScanner on a server which has less than 3GB of memory as ClamAV itself uses nearly 1GB.
  • Root SSH access to the server is required for installation and some configuration actions.

How to Install ConfigServer MailScanner Front End (msfe) in cPanel Server

Since msfe is a premium software, it will require purchasing a license for your server's static IP address before it can be installed to your cPanel server. More information on licensing can be found on the official ConfigServer msfe website.

Once your license has been activated, you can install msfe.

To Install ConfigServer MailScanner Front End (msfe) in cPanel Server, follow the steps:

  1. Login to the cPanel server as root user via SSH.
  2. Download the installer, expand it and go into it:
    tar -xzf msinstall.tar.gz
    cd msinstall/
  3. Install the Free ConfigServer MailScanner on cPanel Server
  4. Please note that the script uses a stable version of MailScanner which might not be the very latest from the developer
  5. Once installed/upgraded/uninstalled, make sure that MailScanner is running correctly and that exim is sending and receiving emails, by tailing the appropriate log files:
    tail -f /var/log/maillog
    tail -f /var/log/exim_mainlog
  6. Install/configure Razor and DCC. Run these commands in ssh as root:
    /usr/local/cpanel/3rdparty/perl/532/bin/razor-admin -create
    /usr/local/cpanel/3rdparty/perl/532/bin/razor-admin -register
    /usr/local/cpanel/3rdparty/perl/536/bin/razor-admin -create
    /usr/local/cpanel/3rdparty/perl/536/bin/razor-admin -register
    cd /usr/src/
    tar -xzf dcc.tar.Z
    cd dcc-*/
    ./configure --disable-dccm
    make install
    sed -i "s/DCCM_LOGDIR=\"log\"/DCCM_LOGDIR=\"\"/" /var/dcc/dcc_conf
    cdcc 'info -N'
    cd ..
    /bin/rm -Rf dcc-* dcc.tar.Z
    (Note: You will get errors for two of the razor-admin commands because only one set of commands will work.)
  7. Ensure that the following ports are open in any software or hardware firewalls:
    DCC - out-bound UDP port 6277
    DCC - out-bound TCP port 587 (for reporting spam)
    Razor - out-bound TCP port 2703
  8. Once your license has been activated, perform the following commands in a root shell on your server via SSH:
    cd /usr/src/
    rm -fv msfe*
    tar -xzf msfeinstaller.tgz
    perl ipv4
    rm -fv msfeinstaller.*
  9. Now, login to WHM using your browser.
  10. Go to WHM > ConfigServer MailScanner FE > MailScanner Configuration and make the following changes:
    1. Set "Virus Scanners = " to "clamd" if you have installed clamav and wish to use the clamd daemon (recommended) with MailScanner.
    2. Search for "Clamd Socket = ". Make sure that value is set to "/var/clamd" and NOT "/tmp/clamd.socket".
    3. You may also wish to set "Spam List = " to an empty field if you are using the RBL blocking in exim.
    4. Set the "%org-name%", "%org-long-name%", and "%web-site%" to your desired settings. Make sure the %org-name% includes ONLY alphanumeric characters, that is, only letters and numbers, NO symbols such as _ or - or even a .
    5. Click "Change" at the bottom once you've made all the above changes.
  11. Some configuration changes are necessary for Exim and MailScanner to both run on the server: See ConfigServer Guide
  12. To access the msfe management interface, navigate to "WHM->Plugins->MailScanner Front End (msfe)".
    Access MailScanner Front End via the WHM plugin interface to manage msfe
  13. That's it! Outgoing Spam Monitor is now installed on cPanel/WHM server.

Using the built-in MailScanner main page provided in the plugin interface, administrators can gain comprehensive insight of the entire inbound mail exchange.

the built-in MailScanner main page provides administrators comprehensive insight of the entire inbound mail exchange


  • mailscanner, cpanel, cpanel plugin, email security, spam filters, spam prevention, spam protection, configserver
  • 0 Users Found This Useful
Was this answer helpful?

Related Articles

Create Spam Filters for Mailing Lists

This document explains how to create mail filter rules in cPanel's Mailing Lists interface (Home...

Video: Create Email Address in cPanel

This video tutorial demonstrates how to create an email address using cPanel Shared Hosting...

Remove a Service from ChkServd Monitoring for cPanel Servers

This guide requires root user account in server. In some circumstances, ChkservD cPanel...

Assigning a Dedicated IP Address to a Subdomain using WHM

To assign a dedicated IP address to a subdomain, perform the following steps: Step 1: Add the...

How to Disable Simplified Account Creation in Outlook 2016

Summary When you configure an Office 365 account in Outlook 2016, you see the...