Skip to content

Installation of the WAF node from DEB or RPM packages on Yandex.Cloud

This quick guide provides the steps to install the WAF node from the source packages on a separate Yandex Compute Cloud instance. By following this guide, you will create an instance from the supported operating system image and install the Wallarm WAF node on this operating system.

The instructions limitations

These instructions do not cover the configuration of load balancing and WAF node autoscaling. If setting up these components yourself, we recommend that you review the instructions on Yandex Network Load Balancer.

Requirements

  • Access to the Yandex.Cloud management console

  • Payment account in the ACTIVE or TRIAL_ACTIVE status displayed on the billing page

  • Folder created. By default, the folder default will be created. To create a new folder, please follow these instructions

  • Access to the account with the Administrator or Deploy role and two‑factor authentication disabled in the Wallarm Console for the EU Cloud or US Cloud

WAF node installation options

Since the WAF node operates as the web server or API gateway module, web server or API gateway packages should be installed on the operating system along with the WAF node packages.

You can select the web server or API gateway that is the most suitable for your application architecture from the following list:

Installing the WAF node as the NGINX Stable module

To install the WAF node as the NGINX Stable module in the Yandex Compute Cloud instance:

  1. Create a Yandex.Cloud instance from the operating system image supported by Wallarm following the Yandex.Cloud instructions:

    • Debian 9.x Stretch
    • Debian 10.x Buster
    • Ubuntu 16.04 Xenial
    • Ubuntu 18.04 Bionic
    • Ubuntu 20.04 Focal
    • CentOS 7.x
    • CentOS 8.x
  2. Connect to the created instance following the Yandex.Cloud instructions.

  3. In the instance, install the packages of NGINX Stable and Wallarm WAF node following the Wallarm instructions.

To install the postanalytics module in a separate instance, please repeat steps 1-2 and install the postanalytics module following the Wallarm instructions.

Installing the WAF node as the NGINX Plus module

To install the WAF node as the NGINX Plus module in the Yandex Compute Cloud instance:

  1. Create a Yandex.Cloud instance from the operating system image supported by Wallarm following the Yandex.Cloud instructions:

    • Debian 9.x Stretch
    • Debian 10.x Buster
    • Ubuntu 16.04 Xenial
    • Ubuntu 18.04 Bionic
    • Ubuntu 20.04 Focal
    • CentOS 7.x
    • CentOS 8.x
  2. Connect to the created instance following the Yandex.Cloud instructions.

  3. In the instance, install the packages of NGINX Plus and Wallarm WAF node following the Wallarm instructions.

To install the postanalytics module in a separate instance, please repeat steps 1-2 and install the postanalytics module following the Wallarm instructions.

Installing the WAF node as the Kong module

To install the WAF node as the Kong module in the Yandex Compute Cloud instance:

  1. Create a Yandex.Cloud instance from the operating system image supported by Wallarm following the Yandex.Cloud instructions:

    • Debian 9.x Stretch
    • Ubuntu 16.04 Xenial
    • Ubuntu 18.04 Bionic
    • CentOS 7.x
  2. Connect to the created instance following the Yandex.Cloud instructions.

  3. In the instance, install Kong of version 1.4.3 or lower following the Kong instructions.

  4. In the instance, install the packages of Wallarm WAF node following the Wallarm instructions.

To install the postanalytics module in a separate instance, please repeat steps 1-2 and install the postanalytics module following the Wallarm instructions.