Kubernetes Support Matrix

This page describes the compatibility matrix of Contour and Kubernetes versions.

Contour utilizes client-go to watch for resources in a Kubernetes cluster. Since Kubernetes is backwards compatible with clients, older client-go versions will work with many different Kubernetes cluster versions. The client-go package includes a compatibility matrix as to what Kubernetes API versions are supported with the version of client-go.

It’s important to note that since Contour consumes a small number of quite stable Kubernetes APIs, most Kubernetes versions most likely will not have issues, however, the client-go package does not guarantee compatibility.


If you are using a Kubernetes distribution offered by a public cloud provider, where you don’t have the option to upgrade to a more recent and supported Kubernetes version (as per the support matrix outlined below), please talk to us on Slack or attend a community meeting. We would like to find a way to satisfy your use case with Contour.

Supported Kubernetes versions

Contour Version Kubernetes Version
master 1.18, 1.17, 1.16
1.6.0 1.18, 1.17, 1.16
1.5.0 1.18, 1.17, 1.16
1.4.0 1.17, 1.16, 1.15
1.3.0 1.17, 1.16, 1.15
1.2.1 1.17, 1.16, 1.15
1.2.0 1.17, 1.16, 1.15
1.1.0 1.15, 1.14, 1.13
1.0.1 1.15, 1.14, 1.13
1.0.0 1.15, 1.14, 1.13
Ready to try Contour?

Read our getting started documentation.