back to home

kubernetes / ingress-nginx

Ingress NGINX Controller for Kubernetes

19,447 stars
8,523 forks
349 issues
GoLuaShell
Chat with CodebaseArchitecture ScanSecurity AuditExplain Codebase

AI Architecture Analysis

This repository is indexed by RepoMind. By analyzing kubernetes/ingress-nginx in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.

Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.

Click here to launch the interactive analysis workspace

Embed this Badge

Showcase RepoMind's analysis directly in your repository's README.

[![Analyzed by RepoMind](https://img.shields.io/badge/Analyzed%20by-RepoMind-4F46E5?style=for-the-badge)](https://repomind-ai.vercel.app/repo/kubernetes/ingress-nginx)
Preview:Analyzed by RepoMind

Repository Summary (README)

Preview

Ingress NGINX Retirement

Retiring

What You Need to Know about Ingress NGINX Retirement:

  • Best-effort maintenance will continue until March 2026.
  • Afterward, there will be no further releases, no bugfixes, and no updates to resolve any security vulnerabilities that may be discovered.
  • Existing deployments of Ingress NGINX will not be broken.
    • Existing project artifacts such as Helm charts and container images will remain available.

Ingress NGINX Controller

CII Best Practices Go Report Card GitHub license GitHub stars

Overview

ingress-nginx was an Ingress controller for Kubernetes using NGINX as a reverse proxy and load balancer.

Learn more about Ingress on the Kubernetes documentation site.

Usage warnings

If you are not already using ingress-nginx, you should not be deploying it as it is not being developed. Instead you should identify a Gateway API implementation and use it.

Do not use in multi-tenant Kubernetes production installations. This project assumes that users that can create Ingress objects are administrators of the cluster. See the FAQ for more.

Troubleshooting

If you encounter issues, review the troubleshooting docs, search for an issue, or talk to us on the #ingress-nginx-users channel on the Kubernetes Slack server.

Changelog

See the list of releases for all changes. For detailed changes for each release, please check the changelog-$version.md file for the release version. For detailed changes on the ingress-nginx helm chart, please check the changelog folder for a specific version. CHANGELOG-$current-version.md file.

Supported Versions table

Supported versions for the ingress-nginx project mean that we have completed E2E tests, and they are passing for the versions listed. Ingress-Nginx versions may work on older versions, but the project does not make that guarantee.

SupportedIngress-NGINX versionk8s supported versionAlpine VersionNginx VersionHelm Chart Version
🔄v1.14.31.34, 1.33, 1.32, 1.31, 1.303.23.21.27.14.14.3
🔄v1.14.21.34, 1.33, 1.32, 1.31, 1.303.23.21.27.14.14.2
🔄v1.14.11.34, 1.33, 1.32, 1.31, 1.303.22.21.27.14.14.1
🔄v1.14.01.34, 1.33, 1.32, 1.31, 1.303.22.21.27.14.14.0
🔄v1.13.71.33, 1.32, 1.31, 1.30, 1.293.23.21.27.14.13.7
🔄v1.13.61.33, 1.32, 1.31, 1.30, 1.293.23.21.27.14.13.6
🔄v1.13.51.33, 1.32, 1.31, 1.30, 1.293.22.21.27.14.13.5
🔄v1.13.41.33, 1.32, 1.31, 1.30, 1.293.22.21.27.14.13.4
🔄v1.13.31.33, 1.32, 1.31, 1.30, 1.293.22.11.27.14.13.3
🔄v1.13.21.33, 1.32, 1.31, 1.30, 1.293.22.11.27.14.13.2
🔄v1.13.11.33, 1.32, 1.31, 1.30, 1.293.22.11.27.14.13.1
🔄v1.13.01.33, 1.32, 1.31, 1.30, 1.293.22.01.27.14.13.0
v1.12.81.32, 1.31, 1.30, 1.29, 1.283.22.21.25.54.12.8
v1.12.71.32, 1.31, 1.30, 1.29, 1.283.22.11.25.54.12.7
v1.12.61.32, 1.31, 1.30, 1.29, 1.283.22.11.25.54.12.6
v1.12.51.32, 1.31, 1.30, 1.29, 1.283.22.11.25.54.12.5
v1.12.41.32, 1.31, 1.30, 1.29, 1.283.22.01.25.54.12.4
v1.12.31.32, 1.31, 1.30, 1.29, 1.283.21.31.25.54.12.3
v1.12.21.32, 1.31, 1.30, 1.29, 1.283.21.31.25.54.12.2
v1.12.11.32, 1.31, 1.30, 1.29, 1.283.21.31.25.54.12.1
v1.12.01.32, 1.31, 1.30, 1.29, 1.283.21.01.25.54.12.0
v1.12.0-beta.01.32, 1.31, 1.30, 1.29, 1.283.20.31.25.54.12.0-beta.0
v1.11.81.30, 1.29, 1.28, 1.27, 1.263.22.01.25.54.11.8
v1.11.71.30, 1.29, 1.28, 1.27, 1.263.21.31.25.54.11.7
v1.11.61.30, 1.29, 1.28, 1.27, 1.263.21.31.25.54.11.6
v1.11.51.30, 1.29, 1.28, 1.27, 1.263.21.31.25.54.11.5
v1.11.41.30, 1.29, 1.28, 1.27, 1.263.21.01.25.54.11.4
v1.11.31.30, 1.29, 1.28, 1.27, 1.263.20.31.25.54.11.3
v1.11.21.30, 1.29, 1.28, 1.27, 1.263.20.01.25.54.11.2
v1.11.11.30, 1.29, 1.28, 1.27, 1.263.20.01.25.54.11.1
v1.11.01.30, 1.29, 1.28, 1.27, 1.263.20.01.25.54.11.0
v1.10.61.30, 1.29, 1.28, 1.27, 1.263.21.01.25.54.10.6
v1.10.51.30, 1.29, 1.28, 1.27, 1.263.20.31.25.54.10.5
v1.10.41.30, 1.29, 1.28, 1.27, 1.263.20.01.25.54.10.4
v1.10.31.30, 1.29, 1.28, 1.27, 1.263.20.01.25.54.10.3
v1.10.21.30, 1.29, 1.28, 1.27, 1.263.20.01.25.54.10.2
v1.10.11.30, 1.29, 1.28, 1.27, 1.263.19.11.25.34.10.1
v1.10.01.29, 1.28, 1.27, 1.263.19.11.25.34.10.0
v1.9.61.29, 1.28, 1.27, 1.26, 1.253.19.01.21.64.9.1
v1.9.51.28, 1.27, 1.26, 1.253.18.41.21.64.9.0
v1.9.41.28, 1.27, 1.26, 1.253.18.41.21.64.8.3
v1.9.31.28, 1.27, 1.26, 1.253.18.41.21.64.8.*
v1.9.11.28, 1.27, 1.26, 1.253.18.41.21.64.8.*
v1.9.01.28, 1.27, 1.26, 1.253.18.21.21.64.8.*
v1.8.41.27, 1.26, 1.25, 1.243.18.21.21.64.7.*
v1.7.11.27, 1.26, 1.25, 1.243.17.21.21.64.6.*
v1.6.41.26, 1.25, 1.24, 1.233.17.01.21.64.5.*
v1.5.11.25, 1.24, 1.233.16.21.21.64.4.*
v1.4.01.25, 1.24, 1.23, 1.223.16.21.19.10†4.3.0
v1.3.11.24, 1.23, 1.22, 1.21, 1.203.16.21.19.10†4.2.5

See Updating NGINX-Ingress to use the stable Ingress API (July 26, 2021) to upgrade to the stable Ingress API before upgrading to Kubernetes 1.22.

Get Involved

Thanks for taking the time to join our community and start contributing!

  • This project adheres to the Kubernetes Community Code of Conduct. By participating in this project, you agree to abide by its terms.

  • Contributing: Documentation contributions are welcome.

    • Read CONTRIBUTING.md for information about the workflow that we expect and instructions on the developer certificate of origin that we require.
    • Join our Kubernetes Slack channel for developer discussion : #ingress-nginx-dev.
    • Submit GitHub issues for documentation problems.
      • Please make sure to read the Issue Reporting Checklist before opening an issue. Issues not conforming to the guidelines may be closed immediately.

  • Support:

License

Apache License 2.0