# Ingress Configurator Charm

> This is the documentation for the Ingress Configurator charm, a Juju charm that acts as a bridge between workloads needing ingress and the route-provider charms that fulfill it. It supports both charm workloads integrating over the ingress interface and external backends described by configuration.


2026

## Pages

- [Ingress configurator operator](https://canonical.com/juju/docs/ingress-configurator-charm/latest/index.html.md): A Juju charm that configures route-provider interfaces (haproxy-route, haproxy-route-tcp, gateway-route) for both charm workloads via the ingress interface and external backends via configuration.
- [Tutorials](https://canonical.com/juju/docs/ingress-configurator-charm/latest/tutorial/index.html.md): Tutorials covering a basic deployment of the `ingress-configurator` charm.
- [Deploy the `ingress-configurator` charm with Gateway API](https://canonical.com/juju/docs/ingress-configurator-charm/latest/tutorial/getting-started/index.html.md): Step-by-step guide for deploying the Ingress Configurator charm to provide ingress to a backend Flask application running on Kubernetes through Gateway API.
- [How-to guides](https://canonical.com/juju/docs/ingress-configurator-charm/latest/how-to/index.html.md): How-to guides for the ingress-configurator charm.
- [How to upgrade](https://canonical.com/juju/docs/ingress-configurator-charm/latest/how-to/upgrade/index.html.md): Upgrade the `ingress-configurator` charm with the `refresh` command:
- [HAProxy guides](https://canonical.com/juju/docs/ingress-configurator-charm/latest/how-to/haproxy/index.html.md): How-to guides for using ingress-configurator with HAProxy.
- [How to route HTTP traffic to a non-charmed workload through HAProxy](https://canonical.com/juju/docs/ingress-configurator-charm/latest/how-to/haproxy/integrate-non-charm-workload/index.html.md): How to route HTTP traffic to a non-charmed workload using ingress-configurator and HAProxy.
- [How to route TCP traffic to a non-charmed workload through HAProxy](https://canonical.com/juju/docs/ingress-configurator-charm/latest/how-to/haproxy/integrate-tcp-non-charm-workload/index.html.md): How to route TCP traffic to a non-charmed workload using ingress-configurator and HAProxy.
- [How to add HAProxy features to an ingress requirer charm](https://canonical.com/juju/docs/ingress-configurator-charm/latest/how-to/haproxy/add-features-to-ingress-requirer/index.html.md): How to use ingress-configurator to provide HAProxy features to charms that only implement the ingress relation.
- [How to load balance a gRPC server through HAProxy](https://canonical.com/juju/docs/ingress-configurator-charm/latest/how-to/haproxy/loadbalancing-grpc/index.html.md): How to use ingress-configurator to load balance a gRPC server through HAProxy.
- [Gateway API guides](https://canonical.com/juju/docs/ingress-configurator-charm/latest/how-to/gateway-api/index.html.md): How-to guides for using ingress-configurator with the Kubernetes Gateway API.
- [How to add Kubernetes Gateway API features to an ingress requirer charm](https://canonical.com/juju/docs/ingress-configurator-charm/latest/how-to/gateway-api/add-features-to-ingress-requirer/index.html.md): Learn how to use ingress-configurator to provide Kubernetes Gateway API features to charms that only implement the ingress relation.
- [How to route traffic for multiple workloads through a single Gateway](https://canonical.com/juju/docs/ingress-configurator-charm/latest/how-to/gateway-api/route-multiple-workloads/index.html.md): Learn how to route traffic for multiple workloads through a single Gateway using ingress-configurator and gateway-api-integrator.
- [Explanation](https://canonical.com/juju/docs/ingress-configurator-charm/latest/explanation/index.html.md): Explanation material explaining key concepts about the Ingress Configurator charm
- [Modes of operation](https://canonical.com/juju/docs/ingress-configurator-charm/latest/explanation/modes-of-operation/index.html.md): An explanation of the four modes of operation of the ingress-configurator charm: HAProxy integrator, HAProxy adapter, and gateway-route adapter.
- [How gateway-route works](https://canonical.com/juju/docs/ingress-configurator-charm/latest/explanation/gateway-route/index.html.md): Explanation of how the gateway-route interface works in the Ingress Configurator charm, including the architecture, data flow, and HTTPS modes.
- [How haproxy-route-tcp works](https://canonical.com/juju/docs/ingress-configurator-charm/latest/explanation/haproxy-route-tcp/index.html.md): Explanation of how the haproxy-route-tcp interface works in the Ingress Configurator charm, including architecture, Layer 4 routing, and key constraints.
- [Reference](https://canonical.com/juju/docs/ingress-configurator-charm/latest/reference/index.html.md): Reference material for the Ingress Configurator charm
- [The cache-config relation](https://canonical.com/juju/docs/ingress-configurator-charm/latest/reference/cache-config/index.html.md): Reference for the cache-config relation interface used by the Ingress Configurator charm, including databag fields.
- [The gateway-route relation](https://canonical.com/juju/docs/ingress-configurator-charm/latest/reference/gateway-route/index.html.md): Reference for the gateway-route relation interface used by the Ingress Configurator charm, including databag fields and https_mode values.
- [Release notes](https://canonical.com/juju/docs/ingress-configurator-charm/latest/release-notes/index.html.md): Release process and history of stable releases for the Ingress Configurator charm.
- [Changelog](https://canonical.com/juju/docs/ingress-configurator-charm/latest/changelog/index.html.md): All notable changes to this project will be documented in this file.