NGINX Documentation

NGINX Ingress Controller Technical Specifications

Supported Kubernetes Versions

The NGINX Ingress Controller has been verified to run on the following Kubernetes versions:

  • Kubernetes 1.14-1.18

Supported Docker Images

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

Images with NGINX

All images include NGINX 1.17.10. The supported architecture is x86-64.

Name Dockerfile* Base image Third-party modules DockerHub image
Debian-based image Dockerfile nginx:1.17.10, which is based on debian:buster-slim   nginx/nginx-ingress:1.7.1
Alpine-based image DockerfileForAlpine nginx:1.17.10-alpine, which is based on alpine:3.10   nginx/nginx-ingress:1.7.1-alpine
Debian-based image with Opentracing DockerfileWithOpentracing nginx:1.17.10, which is based on debian:buster-slim OpenTracing API for C++ 1.5.1, NGINX plugin for OpenTracing, C++ OpenTracing binding for Jaeger 0.4.2  
Ubi-based image openshift/Dockerfile registry.access.redhat.com/ubi8/ubi:8.1   nginx/nginx-ingress:1.7.1-ubi

* – Dockerfile paths are relative to the build folder of the Ingress Controller git repo.

Images with NGINX Plus

All images include NGINX Plus R21. The supported architecture is x86-64.

NGINX Plus images are not available through DockerHub.

Name Dockerfile* Base image Third-party modules
Debian-based image DockerfileForPlus debian:buster-slim  
Debian-based image with Opentracing DockerfileWithOpentracingForPlus debian:buster-slim NGINX Plus OpenTracing module, C++ OpenTracing binding for Jaeger 0.4.2
Ubi-based image openshift/DockerfileForPlus registry.access.redhat.com/ubi8/ubi:8.1  

* – Dockerfile paths are relative to the build folder of the Ingress Controller git repo.

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

The Ingress Controller supports installation via Helm. The supported versions of Helm are 2.16+ and 3.0+.