Installation Guide

• Requirements
• Side by side installation with another IDS
• Installation Instructions
  • Registering
  • SELinux support
• Update Instructions
  • Beta
  • Production
  • Gradual roll-out

Requirements

Operating system

• CentOS/RHEL 6,7,8
• CloudLinux OS 6,7,8
• Ubuntu 16.04 (LTS only), 18.04 and 20.04
• Debian 9 and 10
• AlmaLinux 8

Virtualization

OpenVZ - works for Virtuozzo 7 with kernel 3.10.0-327.10.1.vz7.12.8 or newer.

Hardware

• RAM: 1GB
• HDD: 20GB available disk space

Supported hosting panels

• cPanel
• Plesk (Plesk 17.5 or newer)
• DirectAdmin
• CyberPanel (only CloudLinux OS 7 and 8). See 3rd party integration guide from CyberPanel.
• No hosting panel systems

Required browsers

• Safari version 10 or later
• Chrome version 39 or later
• Firefox version 28 or later
• Edge version 17 or later

Supported Web-servers

• Apache
• LiteSpeed
• Nginx (only in Standalone mode)

Side by side installation with another IDS

Compatible

IDS name	Comment
LiteSpeed	Integrates with version 5.1 or higher.
EasyApache3	Works only in cPanel.
EasyApache4	Works only in cPanel.
CSF	Integrated with CSF, more details here.
CWAF Agent	No problems detected.
Patchman	No problems detected.
Suhosin	We are ignoring alerts by Suhosin.
Cloudflare	Imunify360 supports graylisting IP addresses behind Cloudflare. More details here.
CXS	Special actions required to use Imunify360 with CXS installed.
cPHulk	Imunify360 disables cPHulk during installation. However in case of enabling it back, Imunify360 integrates with it and shows cPHulk events in the incident screen.
OpenVZ	Works for Virtuozzo 7 with kernel 3.10.0-327.10.1.vz7.12.8 or later.
UptimeRobot	No problems detected.

Incompatible

IDS name	Comment
ASL (Atomicorp Secured Linux)	Possibly is not compatible (investigating).
fail2ban	Imunify360 disables fail2ban: the latter resets chains of iptables rules which causes inconsistency with Imunify360

Installation Instructions

Warning

On DirectAdmin, Imunify UI requires the proc_open PHP function to be enabled. If you are unable to open the Imunify UI, you might see a related message in the web server error log. If so, please remove it from the disable_functions list in php.ini.

1. Get your license key at https://www.imunify360.com/. You can purchase it or get a trial key from a received email.

2. Setup or install the prerequisites required for your environment if any.

   • cPanel hosting panel
   • Plesk hosting panel
   • Stand-alone version (no hosting panel)
   • On Debian 10, enable buster-backports:

echo "deb http://ftp.debian.org/debian buster-backports main" > /etc/apt/sources.list.d/backports.list
apt-get update

Warning

Plesk does not have full support for backports repository. It is recommended to disable it after Imunify360 is installed.

1. Log in with root privileges to the server where Imunify360 should be installed.

2. Go to your home directory and run the commands:

wget https://repo.imunify360.cloudlinux.com/defence360/i360deploy.sh -O i360deploy.sh

bash i360deploy.sh --key YOUR_KEY

where YOUR_KEY is your license key. Replace YOUR_KEY with the actual key - trial or purchased at https://www.imunify360.com/ .

To install Imunify360 beta version add argument --beta . For example:

bash i360deploy.sh --key YOUR_KEY --beta

where YOUR_KEY is your license key. Replace YOUR_KEY with the actual key - trial or purchased at https://www.imunify360.com/.

If you have an IP-based license, run the same script with no arguments:

wget https://repo.imunify360.cloudlinux.com/defence360/i360deploy.sh -O i360deploy.sh

bash i360deploy.sh

To view available options for installation script run:

bash i360deploy.sh -h

Registering

In a case of registration key is passed later, then you can register an activation key via the Imunify360-agent command:

imunify360-agent register YOUR_KEY

Where YOUR_KEY is your activation key.

If you have IP-based license, you can use the following command:

imunify360-agent register IPL

SELinux support

If SELinux (Security-Enhanced Linux) is enabled on your server, you should install the Imunify360 SELinux policy module. You can check SELinux status by sestatus command. Policy is shipped with Imunify360 package and is located in the /opt/alt/python38/share/imunify360/imunify360.te

To apply it, run the following commands:

checkmodule -M -m -o /var/imunify360/imunify360.mod /opt/alt/python38/share/imunify360/imunify360.te
semodule_package -o /var/imunify360/imunify360.pp -m /var/imunify360/imunify360.mod
semodule -i /var/imunify360/imunify360.pp

After that, restart imunify360 and imunify360-webshield service. For CentOS6/CloudLinux6:

service imunify360 restart
service imunify360-webshield restart

For other systems:

systemctl restart imunify360
systemctl restart imunify360-webshield

If checkmodule command is not found, please, install it: For CentOS8/CloudLinux 8:

yum install policycoreutils-python-utils

Update Instructions

Note

Updates are unconditionally enabled and the Imunify360 service starts during the package update.

Beta

To upgrade Imunify360 on CentOS/CloudLinux/AlmaLinux systems, run the command:

yum update imunify360-firewall --enablerepo=imunify360-testing

To upgrade Imunify360 on Ubuntu 16.04, run the following command:

echo 'deb https://repo.imunify360.cloudlinux.com/imunify360/ubuntu-testing/16.04/ xenial main' > /etc/apt/sources.list.d/imunify360-testing.list
apt-get update
apt-get install --only-upgrade imunify360-firewall

To upgrade Imunify360 on Ubuntu 18.04, run the following command:

echo 'deb https://repo.imunify360.cloudlinux.com/imunify360/ubuntu-testing/18.04/ bionic main' > /etc/apt/sources.list.d/imunify360-testing.list
apt-get update
apt-get install --only-upgrade imunify360-firewall

To upgrade Imunify360 on Ubuntu 20.04, run the following command:

echo 'deb https://repo.imunify360.cloudlinux.com/imunify360/ubuntu-testing/20.04/ focal main' > /etc/apt/sources.list.d/imunify360-testing.list
apt-get update
apt-get install --only-upgrade imunify360-firewall

To upgrade Imunify360 on Debian 9, run the following command:

echo 'deb https://repo.imunify360.cloudlinux.com/imunify360/debian-testing/9/ stretch main'  > /etc/apt/sources.list.d/imunify360-testing.list
apt-get update
apt-get install --only-upgrade imunify360-firewall

To upgrade Imunify360 on Debian 10, run the following command:

echo 'deb https://repo.imunify360.cloudlinux.com/imunify360/debian-testing/10/ buster main'  > /etc/apt/sources.list.d/imunify360-testing.list
apt-get update
apt-get install --only-upgrade imunify360-firewall

Production

CentOS/CloudLinux/AlmaLinux systems:

yum update imunify360-firewall

Ubuntu 16.04, 18.04, and 20.04 systems:

apt-get update
apt-get install --only-upgrade imunify360-firewall

Debian 9 and 10 systems:

apt-get update
apt-get install --only-upgrade imunify360-firewall

Gradual roll-out

New stable Imunify360 versions are scheduled for the gradual roll-out from our production repository and are available for all customers in about two weeks or less from the release.

If you do not want to wait for the gradual roll-out, you can update Imunify360 to the latest version by running the following commands:

wget https://repo.imunify360.cloudlinux.com/defence360/imunify-force-update.sh
bash imunify-force-update.sh