Image-Filter

Installation

  1. Check the Technical Specifications page to verify that the module is supported by your operating system.

  2. Install the Image-Filter module package nginx-plus-module-image-filter.

    For Amazon Linux 2, CentOS, Oracle Linux, and RHEL:

    sudo yum update && \
sudo yum install nginx-plus-module-image-filter

    For Amazon Linux 2023, AlmaLinux, Rocky Linux:

    sudo dnf update && \
sudo dnf install nginx-plus-module-image-filter

    For Debian and Ubuntu:

    sudo apt update && \
sudo apt install nginx-plus-module-image-filter

    For SLES:

    sudo zypper refresh && \
sudo zypper install nginx-plus-module-image-filter

    For Alpine:

    apk add nginx-plus-module-image-filter

    For FreeBSD:

    sudo pkg update && \
sudo pkg install nginx-plus-module-image-filter

Configuration

After installation you will need to enable and configure the module in F5 NGINX Plus configuration file nginx.conf.

  1. Enable dynamic loading of the module with the load_module directive specified in the top-level (“main”) context:

    load_module modules/ngx_http_image_filter_module.so;

http {
    # ...
}

  2. Perform additional configuration as required by the module.

  3. Test the NGINX Plus configuration. In a terminal, type-in the command:

    nginx -t

    Expected output of the command:

    nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf is successful

  4. Reload the NGINX Plus configuration to enable the module:

    nginx -s reload

More Info

Last modified April 11, 2025