Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 8,412 Commits
.github		.github
build		build
changelog		changelog
charts/ingress-nginx		charts/ingress-nginx
cmd		cmd
deploy		deploy
docs		docs
hack		hack
images		images
internal		internal
magefiles		magefiles
pkg		pkg
rootfs		rootfs
test		test
version		version
.env.example		.env.example
.gcloudignore		.gcloudignore
.gitignore		.gitignore
.golangci.yml		.golangci.yml
.goreleaser.yaml		.goreleaser.yaml
.luacheckrc		.luacheckrc
AIO_BASE		AIO_BASE
CONTRIBUTING.md		CONTRIBUTING.md
Changelog.md		Changelog.md
GOLANG_VERSION		GOLANG_VERSION
ISSUE_TRIAGE.md		ISSUE_TRIAGE.md
LICENSE		LICENSE
MANUAL_RELEASE.md		MANUAL_RELEASE.md
Makefile		Makefile
NEW_CONTRIBUTOR.md		NEW_CONTRIBUTOR.md
NEW_RELEASE_PROCESS.md		NEW_RELEASE_PROCESS.md
NGINX_BASE		NGINX_BASE
OWNERS		OWNERS
OWNERS_ALIASES		OWNERS_ALIASES
README.md		README.md
SECURITY.md		SECURITY.md
SECURITY_CONTACTS		SECURITY_CONTACTS
TAG		TAG
cloudbuild.yaml		cloudbuild.yaml
code-of-conduct.md		code-of-conduct.md
ginkgo_upgrade.md		ginkgo_upgrade.md
go.mod		go.mod
go.sum		go.sum
go.work		go.work
go.work.sum		go.work.sum
mkdocs.yml		mkdocs.yml
netlify.toml		netlify.toml

Repository files navigation

Ingress NGINX Controller

Overview

ingress-nginx is an Ingress controller for Kubernetes usingNGINX as a reverse proxy and loadbalancer.

Learn more about Ingress on the Kubernetes documentation site.

Get started

See theGetting 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 theFAQ for more.

Troubleshooting

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

Changelog

Seethe list of releases for all changes.For detailed changes for each release, please check thechangelog-$version.md file for the release version.For detailed changes on theingress-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 forthe versions listed. Ingress-Nginx versionsmay 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.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.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

Seethis article if you want upgrade to the stableIngress API.

Get Involved

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

This project adheres to theKubernetes Community Code of Conduct.By participating in this project, you agree to abide by its terms.
Contributing: Contributions of all kinds are welcome!
- ReadCONTRIBUTING.md for information about setting up your environment, the workflow that weexpect, 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 theIssue Reporting Checklist before opening an issue. Issues not conforming to the guidelinesmay be closed immediately.
- Join ouringress-nginx-dev mailing list
Support:
- Join the#ingress-nginx-users channel inside theKubernetes Slack to ask questions or get support from the maintainers and other users.
- TheGitHub issues in the repository areexclusively for bug reports and feature requests.
- Discuss: Tweet using the#IngressNginx hashtag or sharing with us@IngressNginx.