Go Shell Lua Makefile Python Dockerfile Other
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.github Update GitHub pull request template Apr 28, 2018
.travis Add scripts and tasks to publish docs to github pages Apr 26, 2018
build Update nginx and e2e images Aug 17, 2018
cmd/nginx Add dynamic certificate feature to controller Aug 17, 2018
deploy missed a spot for the namespace Aug 15, 2018
docs Merge branch 'master' into xff Aug 16, 2018
hack Replace minikube for e2e tests Jul 28, 2018
images Merge pull request #2956 from aledbf/update-nginx-image Aug 17, 2018
internal Merge pull request #2899 from jeroenvand/jvd-fix-rewrite Aug 19, 2018
rootfs batch metrics and flush periodically Aug 18, 2018
test Merge pull request #2899 from jeroenvand/jvd-fix-rewrite Aug 19, 2018
vendor Update go dependencies Jul 12, 2018
version Remove GenericController and add tests Nov 5, 2017
.codecov.yml Migrate to codecov.io (#2120) Feb 20, 2018
.dockerignore Move nginx to root directory Oct 6, 2017
.gitignore Multiple optimizations to build targets Jul 20, 2018
.luacheckrc refactor balancer into more testable and extensible interface May 28, 2018
.travis.yml Fix IPV6 detection Aug 6, 2018
CONTRIBUTING.md Add KubeCon Europe 2018 Video to documentation May 13, 2018
Changelog.md Release 0.18.0 Aug 11, 2018
Gopkg.lock Simplify handler registration and update promhttp Jul 12, 2018
Gopkg.toml Simplify handler registration and update promhttp Jul 12, 2018
LICENSE Initial commit Nov 4, 2016
Makefile Update nginx and e2e images Aug 17, 2018
OWNERS Add new approvers to the project (#2673) Jun 21, 2018
OWNERS_ALIASES Update owners Apr 13, 2018
README.md Add FOSSA status badge Jul 10, 2018
SECURITY_CONTACTS Add security contacts file [ci skip] (#2564) May 24, 2018
code-of-conduct.md Update code-of-conduct.md (#1842) Dec 20, 2017
labels.yaml add labels.yaml file Feb 9, 2017
mkdocs.yml Add google analytics [ci skip] Apr 30, 2018
requirements-docs.txt Update docs and mkdoc dependencies [ci skip] (#2778) Jul 13, 2018


Help us to improve the NGINX Ingress controller completing the survey

NGINX Ingress Controller

Build Status Coverage Status Go Report Card GitHub license GitHub stars GitHub stars FOSSA Status

Get Involved

  • Contributing: Pull requests are welcome!
    • Read CONTRIBUTING.md and check out help-wanted issues
    • Submit github issues for any feature enhancements, bugs or documentation problems
  • Support: Join to Kubernetes Slack to ask questions to get support from the maintainers and other developers
  • Discuss: Tweet using the #IngressNginx hashtag


This repository contains the NGINX controller built around the Kubernetes Ingress resource that uses ConfigMap to store the NGINX configuration. Make Ingress-Nginx Work for you, and the Community from KubeCon Europe 2018 is a great video to get you started!!

Learn more about using Ingress on k8s.io

What is an Ingress Controller?

Configuring a webserver or loadbalancer is harder than it should be. Most webserver configuration files are very similar. There are some applications that have weird little quirks that tend to throw a wrench in things, but for the most part you can apply the same logic to them and achieve a desired result.

The Ingress resource embodies this idea, and an Ingress controller is meant to handle all the quirks associated with a specific "class" of Ingress.

An Ingress Controller is a daemon, deployed as a Kubernetes Pod, that watches the apiserver's /ingresses endpoint for updates to the Ingress resource. Its job is to satisfy requests for Ingresses.


To check out Live Docs


For questions and support please use the #ingress-nginx channel in the Kubernetes Slack or kubernetes-users mailing list. The issue list of this repo is exclusively for bug reports and feature requests.


Please make sure to read the Issue Reporting Checklist before opening an issue. Issues not conforming to the guidelines may be closed immediately.


Detailed changes for each release are documented in the Changelog.md


Please make sure to read the Contributing Guide before making a pull request.

Thank you to all the people who already contributed to NGINX Ingress Controller!

Code of Conduct

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


Apache License 2.0