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.
- Release 3.0.0 provides support for the
discovery.k8s.io/v1API 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 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 | Supported Kubernetes Version | NIC Helm Chart Version | NIC Operator Version | NGINX / NGINX Plus version |
|---|---|---|---|---|
| 3.7.0 | 1.25 - 1.31 | 1.4.0 | 2.4.0 | 1.27.1 / 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 |
| 3.0.2 | 1.21 - 1.26 | 0.16.2 | 1.3.1 | 1.23.3 / R28 |
| 2.4.2 | 1.19 - 1.25 | 0.15.2 | 1.2.1 | 1.23.2 / R28 |
| 2.3.1 | 1.19 - 1.24 | 0.14.1 | 1.1.0 | 1.23.1 / R27 |
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.1.
Name |
Base image |
Third-party modules |
DockerHub image | Architectures |
|---|---|---|---|---|
| Alpine-based image | nginx:1.27.1-alpine,based on on alpine:3.20 |
NGINX OpenTracing module OpenTracing library OpenTracing tracers for Jaeger Zipkin and Datadog |
nginx/nginx-ingress:3.7.0-alpine |
arm/v7 arm64 amd64 ppc64le s390x |
| Debian-based image | nginx:1.27.1,based on on debian:12-slim |
NGINX OpenTracing module OpenTracing library OpenTracing tracers for Jaeger Zipkin and Datadog |
nginx/nginx-ingress:3.7.0 |
arm/v7 arm64 amd64 ppc64le s390x |
| Ubi-based image | redhat/ubi9-minimal |
nginx/nginx-ingress:3.7.0-ubi |
arm64 amd64 ppc64le s390x |
Images with NGINX Plus
NGINX Plus images include NGINX Plus R32.
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.20 |
NGINX Plus JavaScript and OpenTracing modules OpenTracing tracers for Jaeger Zipkin and Datadog |
nginx-ic/nginx-plus-ingress:3.7.0-alpine |
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.7.0 |
arm64 amd64 |
| Debian-based image with NGINX App Protect WAF | debian:12-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.7.0 |
amd64 |
| Debian-based image with NGINX App Protect WAF v5 | debian:12-slim |
NGINX App Protect WAF v5 NGINX Plus JavaScript and OpenTracing modules OpenTracing tracers for Jaeger Zipkin and Datadog |
nginx-ic-nap-v5/nginx-plus-ingress:3.7.0 |
amd64 |
| Debian-based image with NGINX App Protect DoS | debian:12-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.7.0 |
amd64 |
| Debian-based image with NGINX App Protect WAF and DoS | debian:12-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.7.0 |
amd64 |
| Ubi-based image | redhat/ubi9-minimal |
NGINX Plus JavaScript module | nginx-ic/nginx-plus-ingress:3.7.0-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.7.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:3.7.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:3.7.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:3.7.0-ubi |
amd64 |
AWS Marketplace
NGINX Plus images are available through the AWS Marketplace.
View the Use the AWS Marketplace Ingress Controller image topic 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:12-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:12-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:12-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
NGINX Plus images are available through the Google Cloud Marketplace.
View the Use the GCP Marketplace NGINX Ingress Controller image topic 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:12-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
NGINX Plus images are available 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 |
| Debian-based image with NGINX App Protect WAF | debian:12-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 |
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.