Installation Instructions

• Postfix needs to be installed before you begin the installation. If your server is currently running Qmail then complete Switching from Qmail to Postfix
• Dovecot needs to be installed before you begin the installation. If your server is currently running Courier then complete Switching from Courier to Dovecot

Installation using the Plesk interface

  1. Login to the Plesk and go to Extensions then search for Warden. Then press the install button.
  2. Click the newly installed Warden Anti-spam and Virus Protection custom button. Plesk users in the Service Provider view will see the button on the left hand side while users running in the Power User view will see the button on the right hand side under Additional Services. You will be prompted to enter in your license key and start the setup wizard. You can view the installation progress using the command: tail -f /var/log/plesk/panel.log
  3. Run the Warden setup wizard. When running the configuration wizard for the first time it is important to apply the recommended settings for each page to apply the Plesk optimized settings for that section.

Installation using the command line interface

• You must be root in order to run the command line installer.
• The license will be bound to the first public IP address on the servers network card. This IP address should resolve to the servers fully qualified domain name.
• The installer must pass all validation tests (memory tests, repository tests, etc) otherwise the installer will exit and not run.

First install the extension using the following command:

plesk bin extension --install warden

Run the Warden CLI for the setup wizard to active the extension license, download the maxmind geolocation database, and run the application installer:

/usr/local/psa/admin/bin/modules/warden/minion --task=application:setup --license_key=XXX --maxmind_key=XXX --phishtank_key=XXX --autoinstall=1 --content_filter_milter=1 --antivirus=1

The setup will return no output and an exit code of 0 if successful. The install log is located at /var/log/plesk/panel.log

CLI Options

Option Format Description Default
license_key string The extension license key. empty (required)
maxmind_key string The MaxMind license key. See: How to get a key empty
phishtank_key string The PhishTank API key. See: How to get a key empty
autoinstall int (1-0) Set to 1 to run the installer and confgure the application. 1
content_filter_milter int (1-0) Set to 1 to install the Amavisd-milter. 1
antivirus int (1-0) Set to 1 to install the ClamAV antivirus daemon. 1