• Logo
    Traefik K8s charm
  • charmhub.io/traefik-k8s
  • More resources
    • Discourse
    • Matrix
    • GitHub
Contents Menu Expand Light mode Dark mode Auto light/dark, in light mode Auto light/dark, in dark mode Skip to content
Traefik K8s charm documentation
Traefik K8s charm documentation
  • Tutorials
    • TLS termination using a local CA
  • How-to guides
    • Enable BasicAuth
    • Integrate
    • Troubleshoot "Gateway Address Unavailable"
    • Troubleshoot reachability
    • Upgrade
    • Contribute
  • Reference
    • Charm architecture
    • Cryptographic documentation for COS-Lite charms
    • Ingress-related relations
    • Changelog
  • Explanation
    • Security overview
  • Release notes
Back to top
Contribute to this page

Ingress-related relations¶

The Traefik charm provides ingress to another charmed application through a Juju relation. The idea is that if a charm integrates with traefik-k8s then you can integrate the two applications and your application will receive the URL at which ingress is made available.

The Traefik charm supports two standardized interfaces:

  • ingress

    Using this interface, each charmed application can request a single, cluster-unique URL for ingress. You can choose between a domain-name-based URL (your.parameters.domain.com) and a path-based URL (domain.com\your\parameters).

  • ingress-per-unit

    Using this interface, each charmed application can request a cluster-unique URL for each existing unit. This is ideal for applications such as Prometheus, where each remote-write endpoint needs to be routed to separately, and database applications who wish to do client-side load-balancing.

Traefik route charm¶

The Traefik route charm is a proxy charm that sits between Traefik and a charm in need of ingress, and is used to provide low-level access to Traefik configuration, as well as to allow configuration for each relation.

This charm is ideal for use cases where you need the full expressive power of Traefik’s routing configuration, or if you want to use a single Traefik instance to provide domain-name-based URL routing to some charms, but path-based URL routing to others.

Copyright © 2026 CC-BY-SA, Canonical Ltd.
Last updated on Jun 25, 2026
Manage your tracker settings
Contents
  • Ingress-related relations
    • Traefik route charm