Contour

name: Contour
description: >-
  A Kubernetes ingress controller using Envoy proxy that provides dynamic configuration updates and advanced routing
  capabilities for managing external access to services in a cluster.
url: https://projectcontour.io/
tags:
  - Envoy
  - Ingress Controller
  - Kubernetes
  - Networking
  - Proxy
created: '2025-01-01'
modified: '2026-05-19'
apis:
  - aid: contour:contour-httpproxy-api
    name: Contour HTTPProxy API
    description: >-
      Kubernetes Custom Resource Definition that extends the standard Ingress API with advanced routing, multi-team
      support, TLS delegation, and weighted load balancing across multiple backend services. HTTPProxy is Contour's
      primary ingress configuration resource and supports inclusion of routing configuration across namespaces.
    humanURL: https://projectcontour.io/docs/main/config/api/
    baseURL: https://projectcontour.io
    tags:
      - Custom Resource
      - HTTPProxy
      - Ingress
      - Kubernetes
      - Routing
    properties:
      - type: Documentation
        url: https://projectcontour.io/docs/main/config/api/
      - type: Reference
        url: https://projectcontour.io/docs/main/config/api-reference.html
      - type: OpenAPI
        url: openapi/contour-httpproxy-openapi.yml
      - type: JSONSchema
        url: json-schema/contour-httpproxy-schema.json
  - aid: contour:contour-gateway-api
    name: Contour Gateway API
    description: >-
      Contour's implementation of the Kubernetes Gateway API, supporting HTTPRoute and TLSRoute resources for defining
      ingress traffic routing rules. Gateway API is the next-generation Kubernetes ingress standard and Contour provides
      support for GatewayClass, Gateway, HTTPRoute, and related resources.
    humanURL: https://projectcontour.io/docs/1.30/config/gateway-api/
    baseURL: https://projectcontour.io
    tags:
      - Gateway API
      - Ingress
      - Kubernetes
      - Networking
      - Routing
    properties:
      - type: Documentation
        url: https://projectcontour.io/docs/1.30/config/gateway-api/
      - type: Reference
        url: https://projectcontour.io/docs/main/config/api-reference.html
      - type: OpenAPI
        url: openapi/contour-gateway-openapi.yml
  - aid: contour:contour-kubernetes-ingress-api
    name: Contour Kubernetes Ingress API
    description: >-
      Contour's support for the standard Kubernetes Ingress v1 resource, enabling basic ingress use cases such as
      host-based and path-based routing to backend services. Contour watches Ingress v1 resources and translates them
      into Envoy proxy configuration, with support for IngressClass selection and Contour-specific annotations for
      extended configuration.
    humanURL: https://projectcontour.io/docs/main/config/ingress/
    baseURL: https://projectcontour.io
    tags:
      - Ingress
      - Kubernetes
      - Networking
      - Routing
      - Standard API
    properties:
      - type: Documentation
        url: https://projectcontour.io/docs/main/config/ingress/
      - type: Reference
        url: https://projectcontour.io/docs/main/config/annotations/
  - aid: contour:contour-extensionservice-api
    name: Contour ExtensionService API
    description: >-
      Kubernetes Custom Resource Definition for binding gRPC-based extension services to the Contour API.
      ExtensionService resources allow external components to implement Contour API features such as external
      authorization and rate limiting by registering a network service that Contour will route to via Envoy's gRPC
      extension protocol (v3).
    humanURL: https://projectcontour.io/docs/main/config/api/
    baseURL: https://projectcontour.io
    tags:
      - Authorization
      - Custom Resource
      - Extension Service
      - gRPC
      - Kubernetes
    properties:
      - type: Documentation
        url: https://projectcontour.io/docs/main/config/api/
      - type: Reference
        url: https://projectcontour.io/docs/main/config/api-reference.html
  - aid: contour:contour-configuration-api
    name: Contour Configuration API
    description: >-
      Contour's ContourConfiguration Custom Resource Definition (v1alpha1) that provides cluster-scoped configuration of
      a Contour instance, including ingress settings, TLS defaults, timeouts, and feature gates. This API allows
      operators to declaratively manage Contour's runtime behavior through Kubernetes resources instead of command-line
      flags or static config files.
    humanURL: https://projectcontour.io/docs/main/config/api/
    baseURL: https://projectcontour.io
    tags:
      - Configuration
      - Custom Resource
      - Kubernetes
      - Networking
      - Operator
    properties:
      - type: Documentation
        url: https://projectcontour.io/docs/main/config/api/
      - type: Reference
        url: https://projectcontour.io/docs/main/config/api-reference.html
common:
  - type: Website
    url: https://projectcontour.io/
  - type: JSONLD
    url: json-ld/contour-context.jsonld
  - type: JSONSchema
    url: json-schema/contour-httpproxy-schema.json
  - type: Vocabulary
    url: vocabulary/contour-vocabulary.yml
  - type: SpectralRules
    url: rules/contour-httpproxy-rules.yml
  - type: SpectralRules
    url: rules/contour-gateway-rules.yml
  - type: Capability
    url: capabilities/manage-httpproxy-routing.yml
  - type: Capability
    url: capabilities/configure-gateway-api-routing.yml
  - type: GettingStarted
    url: https://projectcontour.io/getting-started/
  - type: Documentation
    url: https://projectcontour.io/docs/main/
  - type: GitHubOrganization
    url: https://github.com/projectcontour
  - type: GitHubRepository
    url: https://github.com/projectcontour/contour
  - type: Support
    url: https://projectcontour.io/resources/support/
  - type: Community
    url: https://projectcontour.io/community/
  - type: Resources
    url: https://projectcontour.io/resources/
  - type: ChangeLog
    url: https://github.com/projectcontour/contour/releases
  - type: Issue Tracker
    url: https://github.com/projectcontour/contour/issues
  - type: Upgrading
    url: https://projectcontour.io/resources/upgrading/
maintainers:
  - FN: Kin Lane
    email: [email protected]