Ingress NGINX Controller for Kubernetes
  • Go 85.5%
  • Lua 7.3%
  • Go Template 2.8%
  • Shell 2.7%
  • Dockerfile 0.7%
  • Other 1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Trevor Dunlap f98bb32198
ci: switch chart release to weekly schedule with version gate (#19)
## Summary
- Move chart release off the `push`-on-`Chart.yaml`-change trigger and
onto a weekly cron (`0 0 * * 1`, Mondays 00:00 UTC) to match
`controller-release.yml`.
- Add a version-gate step: release only runs when
`charts/ingress-nginx/Chart.yaml`'s `version:` differs from the latest
`helm-chart-*` tag — so the weekly tick is a no-op until the chart
version actually bumps.
- `workflow_dispatch` is preserved for ad-hoc manual releases (the gate
still applies).
- Drop Artifact Hub setup and `ah lint` from `chart.yaml` and `ci.yaml`;
we publish only to GitHub releases, so the Artifact Hub annotation lint
adds no value.

  ## Why
Pairing chart releases with the existing weekly controller release
cadence keeps the two release flows aligned and avoids ad-hoc releases
triggered by unrelated edits to `Chart.yaml`. Dropping the unused
Artifact Hub tooling trims the workflow and removes a download from each
run.

Signed-off-by: tdunlap607 <trevor.dunlap@chainguard.dev>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-16 18:40:09 -04:00
.github ci: switch chart release to weekly schedule with version gate (#19) 2026-05-16 18:40:09 -04:00
build Tests: Bump Test Runner to v2.2.9. (#14712) 2026-03-19 20:46:36 +05:30
changelog Release controller v1.15.1/v1.14.5/v1.13.9 & chart v4.15.1/v4.14.5/v4.13.9. (#14738) 2026-03-20 02:50:31 +05:30
charts Chart: fix version bump to 4.15.5 (#18) 2026-05-15 18:21:27 -04:00
cmd Docs: Fix typos. (#14391) 2026-01-19 18:51:14 +05:30
deploy Release controller v1.15.1/v1.14.5/v1.13.9 & chart v4.15.1/v4.14.5/v4.13.9. (#14738) 2026-03-20 02:50:31 +05:30
docs Release controller v1.15.1/v1.14.5/v1.13.9 & chart v4.15.1/v4.14.5/v4.13.9. (#14738) 2026-03-20 02:50:31 +05:30
hack CI: Update Helm to v4.1.3. (#14688) 2026-03-18 15:52:32 +05:30
images fix: backport CVE-2026-42945 (nginx rewrite heap overflow) (#16) 2026-05-14 14:53:20 -04:00
internal Template: Quote proxy_pass. (#14667) 2026-03-09 23:41:14 +05:30
magefiles Mage: Rewrite updateChartValue to obsolete outdated libraries. (#14598) 2026-02-26 18:38:28 +05:30
pkg Util: Fix panic for empty cpu.max file. (#14441) 2026-01-27 04:11:49 +05:30
rootfs Template: Remove path from comment. (#14728) 2026-03-19 23:26:35 +05:30
test [StepSecurity] Apply security best practices (#11) 2026-03-27 15:36:19 -04: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 Template: Quote all location and server_name directives, and escape quotes and backslashes. (#14501) 2026-02-02 23:28:27 +05:30
.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
Changelog.md Fix minor typos (#11935) 2024-09-06 15:59:43 +01:00
cloudbuild.yaml Images: Bump GCB Docker GCloud to v20260127-c1affcc8de. (#14455) 2026-01-27 17:05:48 +05:30
code-of-conduct.md Update code-of-conduct.md (#1842) 2017-12-20 15:34:27 -03:00
CONTRIBUTING.md Update documentation to highlight that the project is retiring (#14364) 2026-01-07 02:47:38 +05:30
ginkgo_upgrade.md Docs: Migrate to AR. (#12807) 2025-02-08 02:55:55 -08:00
go.mod chore: bump gomarkdown (CVE-2026-40890) (#15) 2026-05-12 21:17:54 -04:00
go.sum chore: bump gomarkdown (CVE-2026-40890) (#15) 2026-05-12 21:17:54 -04:00
GOLANG_VERSION bump: upgrade Go to 1.26.2 to fix 7 stdlib CVEs (#13) 2026-05-12 21:18:10 -04: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
Makefile Images: Bump Alpine to v3.23.0. (#14249) 2025-12-08 17:50:09 +01:00
MANUAL_RELEASE.md Docs: Migrate to AR. (#12807) 2025-02-08 02:55:55 -08:00
mkdocs.yml Docs: Bump mkdocs to v9.6.16, fix links. (#13741) 2025-08-11 03:15:07 -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.8. (#14631) 2026-03-08 22:00:12 +01: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 readme: initial emeritoss language (#8) 2026-03-25 16:22:14 -04: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 Chart: fix version bump to 4.15.5 (#18) 2026-05-15 18:21:27 -04:00

Important

This is a supported replacement of the original kubernetes/ingress-nginx repository, which was archived on March 24, 2026.

Community contributions are not being accepted at this time. The documentation has been carried over directly from the original repository and may not reflect recent changes.

We will make a best-effort attempt to address publicly known security vulnerabilities, including CVEs in dependencies and certain source code vulnerabilities when remediation can be achieved safely and with minimal risk. If mitigating a vulnerability would require extensive code changes (for example, adapting to a new API or significant refactoring), we will generally not make that change in order to avoid introducing regressions.

Interested in a CVE-free container image of this project? Contact Chainguard.

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.

Supported Ingress-NGINX version k8s supported version Alpine Version Nginx Version Helm Chart Version
🔄 v1.15.1 1.35, 1.34, 1.33, 1.32, 1.31 3.23.3 1.27.1 4.15.1
🔄 v1.15.0 1.35, 1.34, 1.33, 1.32, 1.31 3.23.3 1.27.1 4.15.0
🔄 v1.14.5 1.34, 1.33, 1.32, 1.31, 1.30 3.23.3 1.27.1 4.14.5
🔄 v1.14.4 1.34, 1.33, 1.32, 1.31, 1.30 3.23.3 1.27.1 4.14.4
🔄 v1.14.3 1.34, 1.33, 1.32, 1.31, 1.30 3.23.2 1.27.1 4.14.3
🔄 v1.14.2 1.34, 1.33, 1.32, 1.31, 1.30 3.23.2 1.27.1 4.14.2
🔄 v1.14.1 1.34, 1.33, 1.32, 1.31, 1.30 3.22.2 1.27.1 4.14.1
🔄 v1.14.0 1.34, 1.33, 1.32, 1.31, 1.30 3.22.2 1.27.1 4.14.0
🔄 v1.13.9 1.33, 1.32, 1.31, 1.30, 1.29 3.23.3 1.27.1 4.13.9
🔄 v1.13.8 1.33, 1.32, 1.31, 1.30, 1.29 3.23.3 1.27.1 4.13.8
🔄 v1.13.7 1.33, 1.32, 1.31, 1.30, 1.29 3.23.2 1.27.1 4.13.7
🔄 v1.13.6 1.33, 1.32, 1.31, 1.30, 1.29 3.23.2 1.27.1 4.13.6
🔄 v1.13.5 1.33, 1.32, 1.31, 1.30, 1.29 3.22.2 1.27.1 4.13.5
🔄 v1.13.4 1.33, 1.32, 1.31, 1.30, 1.29 3.22.2 1.27.1 4.13.4
🔄 v1.13.3 1.33, 1.32, 1.31, 1.30, 1.29 3.22.1 1.27.1 4.13.3
🔄 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.8 1.32, 1.31, 1.30, 1.29, 1.28 3.22.2 1.25.5 4.12.8
v1.12.7 1.32, 1.31, 1.30, 1.29, 1.28 3.22.1 1.25.5 4.12.7
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 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.

License

Apache License 2.0