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 install button.
  2. Click the newly installed Juggernaut Firewall 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.

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, download the maxmind geolocation database, and run the application installer:

/usr/local/psa/admin/bin/modules/juggernaut/minion --task=application:setup --license_key=XXX --maxmind_key=XXX --recaptcha_key=XXX --recaptcha_secret=XXX --autoinstall=1 --messenger=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
recaptcha_key string The reCaptcha (v2) site key. See: How to get a key empty
recaptcha_secret string The reCaptcha (v2) secret key. empty
autoinstall boolean (1-0) Set to 1 to run the installer and confgure the application. 1
messenger boolean (1-0) Set to 1 to enable the messenger service. 1
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