Ingress NGINX Controller for Kubernetes
Go to file
Marco Ebert c66aa896a6
Images: Trigger Test Runner build. (#13960)
2025-09-25 00:58:17 -07:00
.github Bump github/codeql-action from 3.30.1 to 3.30.3 in the actions group (#13940) 2025-09-15 04:44:11 -07:00
build Tests: Bump Ginkgo to v2.25.3. (#13902) 2025-09-04 13:33:16 -07:00
changelog Release controller v1.13.2/v1.12.6 & chart v4.13.2/v4.12.6. (#13867) 2025-08-29 20:21:33 +02:00
charts Chart: Add resize policy. (#13906) 2025-09-08 09:29:28 -07:00
cmd Plugin: Change `rewriteTargetWithoutCaptureGroup` lint to include any numbered capture group. (#13931) 2025-09-12 09:18:07 -07:00
deploy Release controller v1.13.2/v1.12.6 & chart v4.13.2/v4.12.6. (#13867) 2025-08-29 20:21:33 +02:00
docs Docs: Update link to Kubernetes controller documentation. (#13946) 2025-09-23 05:52:17 -07:00
hack CI: Update Helm to v3.19.0. (#13937) 2025-09-14 05:38:07 -07:00
images Images: Trigger Test Runner build. (#13960) 2025-09-25 00:58:17 -07:00
internal Config: Use stronger ciphers first. (#13921) 2025-09-10 12:23:57 -07:00
magefiles CI: Update Helm to v3.18.6. (#13881) 2025-09-01 10:31:12 -07:00
pkg Tests: Enhance SSL Proxy. (#13769) 2025-08-16 11:55:07 -07:00
rootfs Images: Use Alpine v3.22.1. (#13869) 2025-09-01 06:49:14 -07:00
test Tests: Bump Ginkgo to v2.25.3. (#13902) 2025-09-04 13:33:16 -07:00
version Refactor version helper (#4437) 2019-08-13 13:46:16 -04:00
.ct.yaml refactor helm ci tests part I (#11178) 2024-03-31 13:21:33 -07:00
.gcloudignore add gcloud ignore 2023-06-23 09:31:00 -04:00
.gitignore Chart: Improve CI. (#12003) 2024-09-28 14:40:02 +01:00
.golangci.yml Bump golangci/golangci-lint-action from 6.5.2 to 7.0.0 (#13116) 2025-03-29 04:04:34 -07:00
.goreleaser.yaml Reimplement kubectl plugin release workflow (#8812) 2022-08-11 21:22:43 -07:00
.luacheckrc Lua: Remove plugins from `.luacheckrc` & E2E docs. (#11872) 2024-08-26 21:18:18 +02:00
CONTRIBUTING.md Tips for new contributors (#8924) 2022-09-19 06:15:23 -07:00
Changelog.md Fix minor typos (#11935) 2024-09-06 15:59:43 +01:00
GOLANG_VERSION Go: Bump to v1.25.1. (#13896) 2025-09-04 10:53:19 -07:00
ISSUE_TRIAGE.md Fix typos in ISSUE_TRIAGE.md (#7863) 2021-11-04 04:52:03 -07:00
LICENSE Initial commit 2016-11-04 23:54:14 +01:00
MANUAL_RELEASE.md Docs: Migrate to AR. (#12807) 2025-02-08 02:55:55 -08:00
Makefile Make: Add `helm-test` target. (#13652) 2025-07-23 01:30:28 -07:00
NEW_CONTRIBUTOR.md Docs: Replace no-break spaces (U+A0). (#13812) 2025-08-22 08:47:53 +02:00
NEW_RELEASE_PROCESS.md Add mage files for changelog 2023-01-19 11:46:01 -05:00
NGINX_BASE Images: Bump NGINX to v2.2.3. (#13957) 2025-09-24 23:10:14 -07:00
OWNERS rikatz is stepping down (#12486) 2024-12-15 18:42:43 +01:00
OWNERS_ALIASES Repository: Update owners. (#12519) 2024-12-21 23:36:09 +01:00
README.md Release controller v1.13.2/v1.12.6 & chart v4.13.2/v4.12.6. (#13867) 2025-08-29 20:21:33 +02:00
SECURITY.md Add SECURITY.md 2020-07-27 16:01:17 -06:00
SECURITY_CONTACTS rikatz is stepping down (#12486) 2024-12-15 18:42:43 +01:00
TAG Images: Trigger controller build. (#13585) 2025-06-30 23:10:32 -07:00
cloudbuild.yaml Images: Bump GCB Docker GCloud to v20250513-9264efb079. (#13393) 2025-05-21 08:18:35 -07:00
code-of-conduct.md Update code-of-conduct.md (#1842) 2017-12-20 15:34:27 -03:00
ginkgo_upgrade.md Docs: Migrate to AR. (#12807) 2025-02-08 02:55:55 -08:00
go.mod Go: Update dependencies. (#13954) 2025-09-25 00:50:21 -07:00
go.sum Go: Update dependencies. (#13954) 2025-09-25 00:50:21 -07:00
mkdocs.yml Docs: Bump mkdocs to v9.6.16, fix links. (#13741) 2025-08-11 03:15:07 -07:00
netlify.toml netlify: Only trigger preview when there are changes in docs. (#10144) 2023-06-27 11:50:32 -07:00

README.md

Ingress NGINX Controller

CII Best Practices Go Report Card GitHub license GitHub stars GitHub stars

Overview

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

Learn more about Ingress on the Kubernetes documentation site.

Get started

See the Getting Started document.

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, file an issue, or talk to us on the #ingress-nginx 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.

Supported Ingress-NGINX version k8s supported version Alpine Version Nginx Version Helm Chart Version
🔄 v1.13.2 1.33, 1.32, 1.31, 1.30, 1.29 3.22.1 1.27.1 4.13.2
🔄 v1.13.1 1.33, 1.32, 1.31, 1.30, 1.29 3.22.1 1.27.1 4.13.1
🔄 v1.13.0 1.33, 1.32, 1.31, 1.30, 1.29 3.22.0 1.27.1 4.13.0
🔄 v1.12.6 1.32, 1.31, 1.30, 1.29, 1.28 3.22.1 1.25.5 4.12.6
🔄 v1.12.5 1.32, 1.31, 1.30, 1.29, 1.28 3.22.1 1.25.5 4.12.5
🔄 v1.12.4 1.32, 1.31, 1.30, 1.29, 1.28 3.22.0 1.25.5 4.12.4
🔄 v1.12.3 1.32, 1.31, 1.30, 1.29, 1.28 3.21.3 1.25.5 4.12.3
🔄 v1.12.2 1.32, 1.31, 1.30, 1.29, 1.28 3.21.3 1.25.5 4.12.2
🔄 v1.12.1 1.32, 1.31, 1.30, 1.29, 1.28 3.21.3 1.25.5 4.12.1
🔄 v1.12.0 1.32, 1.31, 1.30, 1.29, 1.28 3.21.0 1.25.5 4.12.0
🔄 v1.12.0-beta.0 1.32, 1.31, 1.30, 1.29, 1.28 3.20.3 1.25.5 4.12.0-beta.0
v1.11.8 1.30, 1.29, 1.28, 1.27, 1.26 3.22.0 1.25.5 4.11.8
v1.11.7 1.30, 1.29, 1.28, 1.27, 1.26 3.21.3 1.25.5 4.11.7
v1.11.6 1.30, 1.29, 1.28, 1.27, 1.26 3.21.3 1.25.5 4.11.6
v1.11.5 1.30, 1.29, 1.28, 1.27, 1.26 3.21.3 1.25.5 4.11.5
v1.11.4 1.30, 1.29, 1.28, 1.27, 1.26 3.21.0 1.25.5 4.11.4
v1.11.3 1.30, 1.29, 1.28, 1.27, 1.26 3.20.3 1.25.5 4.11.3
v1.11.2 1.30, 1.29, 1.28, 1.27, 1.26 3.20.0 1.25.5 4.11.2
v1.11.1 1.30, 1.29, 1.28, 1.27, 1.26 3.20.0 1.25.5 4.11.1
v1.11.0 1.30, 1.29, 1.28, 1.27, 1.26 3.20.0 1.25.5 4.11.0
v1.10.6 1.30, 1.29, 1.28, 1.27, 1.26 3.21.0 1.25.5 4.10.6
v1.10.5 1.30, 1.29, 1.28, 1.27, 1.26 3.20.3 1.25.5 4.10.5
v1.10.4 1.30, 1.29, 1.28, 1.27, 1.26 3.20.0 1.25.5 4.10.4
v1.10.3 1.30, 1.29, 1.28, 1.27, 1.26 3.20.0 1.25.5 4.10.3
v1.10.2 1.30, 1.29, 1.28, 1.27, 1.26 3.20.0 1.25.5 4.10.2
v1.10.1 1.30, 1.29, 1.28, 1.27, 1.26 3.19.1 1.25.3 4.10.1
v1.10.0 1.29, 1.28, 1.27, 1.26 3.19.1 1.25.3 4.10.0
v1.9.6 1.29, 1.28, 1.27, 1.26, 1.25 3.19.0 1.21.6 4.9.1
v1.9.5 1.28, 1.27, 1.26, 1.25 3.18.4 1.21.6 4.9.0
v1.9.4 1.28, 1.27, 1.26, 1.25 3.18.4 1.21.6 4.8.3
v1.9.3 1.28, 1.27, 1.26, 1.25 3.18.4 1.21.6 4.8.*
v1.9.1 1.28, 1.27, 1.26, 1.25 3.18.4 1.21.6 4.8.*
v1.9.0 1.28, 1.27, 1.26, 1.25 3.18.2 1.21.6 4.8.*
v1.8.4 1.27, 1.26, 1.25, 1.24 3.18.2 1.21.6 4.7.*
v1.7.1 1.27, 1.26, 1.25, 1.24 3.17.2 1.21.6 4.6.*
v1.6.4 1.26, 1.25, 1.24, 1.23 3.17.0 1.21.6 4.5.*
v1.5.1 1.25, 1.24, 1.23 3.16.2 1.21.6 4.4.*
v1.4.0 1.25, 1.24, 1.23, 1.22 3.16.2 1.19.10† 4.3.0
v1.3.1 1.24, 1.23, 1.22, 1.21, 1.20 3.16.2 1.19.10† 4.2.5

See this article if you want upgrade to the stable Ingress API.

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: Contributions of all kinds are welcome!

    • Read CONTRIBUTING.md for information about setting up your environment, 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 any feature enhancements, bugs, or 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.
    • Join our ingress-nginx-dev mailing list
  • Support:

License

Apache License 2.0