Technical specifications

This page describes technical specifications for F5 NGINX Ingress Controller, such as its version compatibility with Kubernetes and other NGINX software.

Supported NGINX Ingress Controller versions

We recommend using the latest release of NGINX Ingress Controller. We provide software updates for the most recent release. We provide technical support for F5 customers who are using the most recent version of NGINX Ingress Controller, and any version released within two years of the current release. We test NGINX Ingress Controller on a range of Kubernetes platforms for each release, and list them in the release notes. We provide technical support for NGINX Ingress Controller on any Kubernetes platform that is currently supported by its provider, and that passes the Kubernetes conformance tests.

NIC version Kubernetes versions tested NIC Helm Chart version NIC Operator version NGINX / NGINX Plus version
5.0.0 1.25 - 1.32 2.1.0 3.1.0 1.27.4 / R34
4.0.1 1.25 - 1.32 2.0.1 3.0.1 1.27.4 / R33 P2
3.7.2 1.25 - 1.31 1.4.2 2.4.2 1.27.2 / R32 P1
3.6.2 1.25 - 1.31 1.3.2 2.3.2 1.27.1 / R32 P1
3.5.2 1.23 - 1.30 1.2.2 2.2.2 1.27.0 / R32
3.4.3 1.23 - 1.29 1.1.3 2.1.2 1.25.4 / R31 P1
3.3.2 1.22 - 1.28 1.0.2 2.0.2 1.25.3 / R30
3.2.1 1.22 - 1.27 0.18.1 1.5.1 1.25.2 / R30
3.1.1 1.22 - 1.26 0.17.1 1.4.2 1.23.4 / R29

Supported Docker images

We provide the following Docker images, which include NGINX or NGINX Plus bundled with the Ingress Controller binary.

Images with NGINX

Important From release v5.1.0 onwards, NGINX Ingress Controller will no longer provide binaries for the armv7, s390x & ppc64le architectures.

All images include NGINX 1.27.4.

Name
Base image
 DockerHub image Architectures
Alpine-based image nginx:1.27.4-alpine,
based on on alpine:3.21		 nginx/nginx-ingress:5.0.0-alpine arm/v7
arm64
amd64
ppc64le
s390x
Debian-based image nginx:1.27.4,
based on on debian:12-slim		 nginx/nginx-ingress:5.0.0 arm/v7
arm64
amd64
ppc64le
s390x
Ubi-based image redhat/ubi9-minimal nginx/nginx-ingress:5.0.0-ubi arm64
amd64
ppc64le
s390x

Images with NGINX Plus

NGINX Plus images include NGINX Plus R34.

F5 Container registry

NGINX Plus images are available through the F5 Container registry private-registry.nginx.com, explained in the Get the NGINX Ingress Controller image with JWT and Get the F5 Registry NGINX Ingress Controller image topics.

Name
Base image
Third-party modules
 F5 Container Registry Image Architectures
Alpine-based image alpine:3.21 NGINX Plus & JavaScript nginx-ic/nginx-plus-ingress:5.0.0-alpine arm64
amd64
Alpine-based image with FIPS inside alpine:3.21 NGINX Plus & JavaScript

FIPS module and OpenSSL configuration		 nginx-ic/nginx-plus-ingress:5.0.0-alpine-fips arm64
amd64
Alpine-based image with NGINX App Protect WAF & FIPS inside alpine:3.19 NGINX App Protect WAF

NGINX Plus & JavaScript

FIPS module and OpenSSL configuration		 nginx-ic-nap/nginx-plus-ingress:5.0.0-alpine-fips amd64
Alpine-based image with NGINX App Protect WAF v5 & FIPS inside alpine:3.19 NGINX App Protect WAF v5

NGINX Plus & JavaScript

FIPS module and OpenSSL configuration		 nginx-ic-nap-v5/nginx-plus-ingress:5.0.0-alpine-fips amd64
Debian-based image debian:12-slim NGINX Plus & JavaScript nginx-ic/nginx-plus-ingress:5.0.0 arm64
amd64
Debian-based image with NGINX App Protect WAF debian:12-slim NGINX App Protect WAF

NGINX Plus & JavaScript

Zipkin and Datadog		 nginx-ic-nap/nginx-plus-ingress:5.0.0 amd64
Debian-based image with NGINX App Protect WAF v5 debian:12-slim NGINX App Protect WAF v5

NGINX Plus & JavaScript		 nginx-ic-nap-v5/nginx-plus-ingress:5.0.0 amd64
Debian-based image with NGINX App Protect DoS debian:12-slim NGINX App Protect DoS

NGINX Plus & JavaScript		 nginx-ic-dos/nginx-plus-ingress:5.0.0 amd64
Debian-based image with NGINX App Protect WAF and DoS debian:12-slim NGINX App Protect WAF and DoS

NGINX Plus & JavaScript		 nginx-ic-nap-dos/nginx-plus-ingress:5.0.0 amd64
Ubi-based image redhat/ubi9-minimal NGINX Plus JavaScript module nginx-ic/nginx-plus-ingress:5.0.0-ubi arm64
amd64
Ubi-based image with NGINX App Protect WAF redhat/ubi9 NGINX App Protect WAF and NGINX Plus JavaScript module nginx-ic-nap/nginx-plus-ingress:5.0.0-ubi amd64
Ubi-based image with NGINX App Protect WAF v5 redhat/ubi9 NGINX App Protect WAF v5 and NGINX Plus JavaScript module nginx-ic-nap-v5/nginx-plus-ingress:5.0.0-ubi amd64
Ubi-based image with NGINX App Protect DoS redhat/ubi8 NGINX App Protect DoS and NGINX Plus JavaScript module nginx-ic-dos/nginx-plus-ingress:5.0.0-ubi amd64
Ubi-based image with NGINX App Protect WAF and DoS redhat/ubi8 NGINX App Protect WAF and DoS

NGINX Plus JavaScript module		 nginx-ic-nap-dos/nginx-plus-ingress:5.0.0-ubi amd64

Custom images

You can customize an existing Dockerfile or use it as a reference to create a new one, which is necessary when:

  • Choosing a different base image.
  • Installing additional NGINX modules.

Supported Helm versions

NGINX Ingress Controller can be installed using Helm 3.0 or later.