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.
• 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:

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