Technical Specifications

NGINX Ingress Controller Technical Specifications.

Supported NGINX Ingress Controller Versions

We recommend upgrading to the latest release of the 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.

Release 3.0.0 provides support for the discovery.k8s.io/v1 API version of EndpointSlice, available from Kubernetes 1.21 onwards. Release 2.4.2 is compatible with the Kubernetes Ingress v1 API, available in Kubernetes 1.19 and later. Release 1.12 supports the Ingress v1beta1 API and continues to receive security fixes to support environments running Kubernetes versions older than 1.19. The v1beta1 Ingress API was deprecated in Kubernetes release 1.19, and removed in the Kubernetes 1.22.

Supported Kubernetes Versions

We explicitly test NGINX Ingress Controller on a range of Kubernetes platforms for each release, and we 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 which passes the Kubernetes conformance tests.

NIC Version Supported Kubernetes Version NIC Helm Chart Version NIC Operator Version NGINX / NGINX Plus version
3.5.2 1.30 - 1.23 1.2.2 2.2.2 1.27.0 / R32
3.4.3 1.29 - 1.23 1.1.3 2.1.2 1.25.4 / R31 P1
3.3.2 1.28 - 1.22 1.0.2 2.0.2 1.25.3 / R30
3.2.1 1.27 - 1.22 0.18.1 1.5.1 1.25.2 / R30
3.1.1 1.26 - 1.22 0.17.1 1.4.2 1.23.4 / R29
3.0.2 1.26 - 1.21 0.16.2 1.3.1 1.23.3 / R28
2.4.2 1.25 - 1.19 0.15.2 1.2.1 1.23.2 / R28
2.3.1 1.24 - 1.19 0.14.1 1.1.0 1.23.1 / R27
2.2.2 1.23 - 1.19 0.13.2 1.0.0 1.21.6 / R26
2.1.2 1.23 - 1.19 0.12.1 0.5.1 1.21.6 / R26
2.0.3 1.22 - 1.19 0.11.3 0.4.0 1.21.3 / R25
1.12.4 1.21 - 1.16 0.10.4 0.3.0 1.21.6 / R26
1.11.3 1.20 - 1.16 0.9.0 0.2.0 1.21.0 / R23 P1
1.10.1 1.19 - 1.16 0.8.0 0.1.0 1.19.8 / R23
1.9.1 1.18 - 1.16 0.7.1 0.0.7 1.19.3 / R22

Supported Docker Images

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

Images with NGINX

All images include NGINX 1.27.0.

Name
Base image
Third-party modules
DockerHub image Architectures
Alpine-based image nginx:1.27.0-alpine,
based on on alpine:3.19
NGINX OpenTracing module

OpenTracing library

OpenTracing tracers for Jaeger

Zipkin and Datadog
nginx/nginx-ingress:3.5.2-alpine arm/v7
arm64
amd64
ppc64le
s390x
Debian-based image nginx:1.27.0,
based on on debian:12-slim
NGINX OpenTracing module

OpenTracing library

OpenTracing tracers for Jaeger

Zipkin and Datadog
nginx/nginx-ingress:3.5.2 arm/v7
arm64
amd64
ppc64le
s390x
Ubi-based image nginxcontrib/nginx:1.27.0-ubi,
based on on redhat/ubi9-minimal
nginx/nginx-ingress:3.5.2-ubi arm64
amd64
ppc64le
s390x

Images with NGINX Plus

NGINX Plus images include NGINX Plus R31.

F5 Container registry

NGINX Plus images are available through the F5 Container registry private-registry.nginx.com - see Getting the NGINX Ingress Controller Image with JWT and Getting the F5 Registry NGINX Ingress Controller Image.

Name
Base image
Third-party modules
F5 Container Registry Image Architectures
Alpine-based image alpine:3.19 NGINX Plus JavaScript and OpenTracing modules

OpenTracing tracers for Jaeger

Zipkin and Datadog
nginx-ic/nginx-plus-ingress:3.5.2-alpine arm64
amd64
Alpine-based image with FIPS inside alpine:3.19 NGINX Plus JavaScript and OpenTracing modules

OpenTracing tracers for Jaeger

Zipkin and Datadog

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

NGINX Plus JavaScript and OpenTracing modules

OpenTracing tracers for Jaeger

Zipkin and Datadog

FIPS module and OpenSSL configuration
nginx-ic-nap/nginx-plus-ingress:3.5.2-alpine-fips arm64
amd64
Debian-based image debian:12-slim NGINX Plus JavaScript and OpenTracing modules

OpenTracing tracers for Jaeger

Zipkin and Datadog
nginx-ic/nginx-plus-ingress:3.5.2 arm64
amd64
Debian-based image with NGINX App Protect WAF debian:11-slim NGINX App Protect WAF

NGINX Plus JavaScript and OpenTracing modules

OpenTracing tracers for Jaeger

Zipkin and Datadog
nginx-ic-nap/nginx-plus-ingress:3.5.2 amd64
Debian-based image with NGINX App Protect DoS debian:11-slim NGINX App Protect DoS

NGINX Plus JavaScript and OpenTracing modules

OpenTracing tracers for Jaeger

Zipkin and Datadog
nginx-ic-dos/nginx-plus-ingress:3.5.2 amd64
Debian-based image with NGINX App Protect WAF and DoS debian:11-slim NGINX App Protect WAF and DoS

NGINX Plus JavaScript and OpenTracing modules

OpenTracing tracers for Jaeger

Zipkin and Datadog
nginx-ic-nap-dos/nginx-plus-ingress:3.5.2 amd64
Ubi-based image redhat/ubi9-minimal NGINX Plus JavaScript module nginx-ic/nginx-plus-ingress:3.5.2-ubi arm64
amd64
s390x
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:3.5.2-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:3.5.2-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:3.5.2-ubi amd64

AWS Marketplace

We also provide NGINX Plus images through the AWS Marketplace. Please see Using the AWS Marketplace Ingress Controller Image for details on how to set up the required IAM resources in your EKS cluster.

Name
Base image
Third-party modules
AWS Marketplace Link Architectures
Debian-based image debian:12-slim NGINX Plus JavaScript and OpenTracing modules

OpenTracing tracers for Jaeger

Zipkin and Datadog
F5 NGINX Ingress Controller amd64
Debian-based image with NGINX App Protect WAF debian:11-slim NGINX App Protect WAF

NGINX Plus JavaScript and OpenTracing modules

OpenTracing tracers for Jaeger

Zipkin and Datadog
F5 NGINX Ingress Controller with F5 NGINX App Protect WAF amd64
Debian-based image with NGINX App Protect DoS debian:11-slim NGINX App Protect DoS

NGINX Plus JavaScript and OpenTracing modules

OpenTracing tracers for Jaeger

Zipkin and Datadog
F5 NGINX Ingress Controller with F5 NGINX App Protect WAF and DoS amd64
Debian-based image with NGINX App Protect WAF and DoS debian:11-slim NGINX App Protect WAF and DoS

NGINX Plus JavaScript and OpenTracing modules

OpenTracing tracers for Jaeger

Zipkin and Datadog
F5 NGINX Ingress Controller with F5 NGINX App Protect DoS amd64

Google Cloud Marketplace

We also provide NGINX Plus images through the Google Cloud Marketplace. Please see Using the GCP Marketplace NGINX Ingress Controller Image for details on how to use them.

Name
Base image
Third-party modules
GCP Marketplace Link Architectures
Debian-based image debian:12-slim NGINX Plus JavaScript and OpenTracing modules

OpenTracing tracers for Jaeger

Zipkin and Datadog
F5 NGINX Ingress Controller amd64
Debian-based image with NGINX App Protect WAF debian:11-slim NGINX App Protect WAF

NGINX Plus JavaScript and OpenTracing modules

OpenTracing tracers for Jaeger

Zipkin and Datadog
F5 NGINX Ingress Controller w/ F5 NGINX App Protect WAF amd64

Microsoft Azure Marketplace

We also provide NGINX Plus image through the Microsoft Azure Marketplace.

Name
Base image
Third-party modules
Azure Marketplace Link Architectures
Debian-based image debian:12-slim NGINX Plus JavaScript and OpenTracing modules

OpenTracing tracers for Jaeger

Zipkin and Datadog
F5 NGINX Ingress Controller amd64

Custom Images

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

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

Supported Helm Versions

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