Installation Instructions

• You should not run any other iptables firewall configuration scripts as they will conflict and cause the CSF to not function properly.
• If you are on a slow connection it might take few minutes to upload the Juggernaut Firewall extension to your server.

Installation using the Plesk interface

  1. Login to the Plesk and go to Extensions then search for Juggernaut. Then press the Get it Free button.
  2. Click the newly installed Juggernaut Firewall custom button on the left hand side of the navigation.
  3. You will be prompted to enter in your license key and start the setup wizard. You must go though the entire wizard in order to disable it. 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. You can view the installation progress using the command: tail -f /var/log/plesk/panel.log

Configuration Tasks

The installer will automatically handle most configration tasks but its recommended that you familiarize yourself with the tasks that are performed by the installer:

Virtuosso / OpenVZ Tasks

Virtuosso 6 / OpenVZ users need to make sure that the required iptables modules are loaded in the hardware node. See: Virtuosso / OpenVZ tasks

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.
• If re-using an existing license from another server then make sure that the license is in the re-issued state. See here for how to re-issue your license.
• The installer must pass all validation tests (memory tests, repository tests, etc) otherwise the installer will exit and not run.
• The firewall will be started and TESTING mode will be disabled so it is recommended to use the --allow_ipaddress and --ignore_ipaddress options so you do not accidently lock yourself out of the server.

First install the extension using the following command:

plesk bin extension --install juggernaut

Run the Warden CLI for the setup wizard to active the extension license, run the application installer, and configure the application:

juggernaut --task=application:setup --license_key=XXX

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
Value Default Description
--license_key <string> The extension license key.
--autoinstall <1|0> 1 Set to 1 to run the installer and confgure the application.
--maxmind_key <string> The MaxMind geolocation license key. See: How to get a key
--recaptcha_key <string> The reCaptcha (v2) site key. See: How to get a key
--recaptcha_secret <string> The reCaptcha (v2) secret key.
--abuseipdb_key <string> The AbuseIPDB reputation provider API key. See: How to get a key
--abuseipdb_block_reporting <1|0> 0 Set to 1 to enable the AbuseIPDB block reporting.
--messenger <1|0> 1 Set to 1 to enable the messenger service.
--maxminddb <1|0> 0 Set to 1 to enable the Apache maxminddb geolocation module.
--geofilter <1|0> 0 Set to 1 to enable server wide geo filtering. The maxminddb option is required when setting this option.
--allow_ipaddress <string> Set to an IP address that you want added to allow permently.
--ignore_ipaddress <string> Set to an IP address that you want added to ignore permently.