This article explains how to install the SpamStopsHere cPanel plugin into a managed cPanel interface.

Required Perl Modules

While many of these Perl modules will already be installed on your cPanel server, you'll want to be sure that you have at least the following:

  • JSON
  • JSON::XS
  • Data::Dumper
  • DBI
  • DBD::mysql
  • File::Copy
  • IO::Socket::SSL
  • Sys::Hostname
  • YAML::Syck

A simple way to see if a module is installed is to run the following perl command:

/usr/bin/perl -M<Package::Name> -e 1

where <Package::Name> is the name of one of the packages listed above. For example:

/usr/bin/perl -MJSON -e 1

If the command does not return an error, the package is installed. If any are missing, you can install them quickly following this module installation guide

Installing WHM

Step 1 - Get and Upload the Package

Download the SpamStopsHere CPanel plugin spamstopshere.tar.gz to your local machine, then upload the file to a directory of your choice on your cPanel server.

Step 2 - Connect to Cpanel Server

Open an SSH session into your cPanel server and change directory to the location of the spamstopshere.tar.gz file.

Step 3 - Extract & Install Package

As root, run:

tar -zxvf spamstopshere.tar.gz && cd spamstopshere && /usr/bin/perl spamstopshere_installer.pl


To make sure the app can run when logged in as root. Add this to /var/cpanel/cpanel.config:

permit_unregistered_apps_as_root=1


Then, run:

/usr/local/cpanel/etc/init/startcpsrvd

Step 4 - Log Into WHM

Browse to your cPanel URL and login as root.

Uninstalling

There is an uninstallation script included with the tarball. In order to uninstall, simply move to the directory that included the source:

cd spamstopshere
./spamstopshere_uninstall.sh

You will need to give the script the absolute path to the "spamstopshere" directory that was created.

Other Resources