Contour is an Ingress controller for Kubernetes that works by deploying the Envoy proxy as a reverse proxy and load balancer. Contour supports dynamic configuration updates out of the box while maintaining a lightweight profile.

Contour also introduces a new ingress API (HTTPProxy) which is implemented via a Custom Resource Definition (CRD). Its goal is to expand upon the functionality of the Ingress API to allow for a richer user experience as well as solve shortcomings in the original design.

Contour requires Kubernetes version 1.16 or later, for v1 Custom Resource Definition support.

RBAC must be enabled on your cluster.

Getting started with Contour is as simple as one command. See the Getting Started document.

If you encounter issues, review the Troubleshooting section of the docs, file an issue, or talk to us on the #contour channel on the Kubernetes Slack server.

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

• Please familiarize yourself with the Code of Conduct before contributing.
• See 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.
• Check out the open issues.
• Join our Kubernetes Slack channel: #contour
• Join the Contour Community Meetings - schedule, notes, and recordings can be found here

See Contour's roadmap to learn more about where we are headed.

See the list of releases to find out about feature changes.