Skip to content
The Things Stack documentation home
Getting Started Concepts Cloud Enterprise Integrations API Hardware
Getting Started Concepts
Cloud Enterprise
Integrations API Hardware
Get The Things Stack

    Recent searches

      Popular pages

      • Getting Started
      • Adding Gateways
      • Adding Devices
      • Payload Formatters
      • Webhooks
      • Authentication

      No results for “”.

      • Check the spelling, or try fewer or more general words.
      • Ask the community on The Things Network Forum
      • Contact support
      ↑↓ to navigate ↵ to open Esc to close

      The Things Stack Enterprise

      • Overview
      • AWS
      • Kubernetes
        • Generic
          • Prerequisites
            • Sample ingress controllers
          • Preparation
          • Configuration
          • Install Charts
          • Monitoring
          • Troubleshooting
          • Database Migrations
        • Azure
      • Docker
      • The Things Join Server
      • Manage The Things Stack

      Sample ingress controllers

      Updated 15 December 2025 Edit on GitHub
      Copy page
      • View as MarkdownThis page as plain text
      • Open in ChatGPTAsk questions about this page
      • Open in ClaudeAsk questions about this page

      The following are examples of ingress controller configurations for The Things Stack deployment on Kubernetes. These examples serve only as general guidelines — the exact configuration may vary based on the user’s environment and infrastructure.

      Traefik

      Example of a Traefik configuration. More info about the Helm chart can be found here.

      The Things Stack Helm chart ingress configuration:

      global:
        ingress:
          controller: "traefik"
          tls:
            secretName: "ingress-tls-cert"
          annotations:
            http:
              traefik.ingress.kubernetes.io/router.entrypoints: web,websecure
              traefik.ingress.kubernetes.io/router.tls: "true"
            grpc:
              traefik.ingress.kubernetes.io/router.entrypoints: grpc,grpcsecure
              traefik.ingress.kubernetes.io/router.tls: "true"
            # LoRa Basics™ Station LNS.
            semtechws:
              traefik.ingress.kubernetes.io/router.entrypoints: semtechws,semtechwssecure
              traefik.ingress.kubernetes.io/router.tls: "true"
            # LoRa Basics™ Station CUPS (in addition to the LNS configuration above). New in v1.1.0.
            semtechcups:
              traefik.ingress.kubernetes.io/router.middlewares: "<traefik-namespace>-buffering@kubernetescrd"
            # The Things Industries Gateway Protocol.
            ttigw:
              traefik.ingress.kubernetes.io/router.entrypoints: ttigw,ttigwsecure
              traefik.ingress.kubernetes.io/router.middlewares: traefik-passtlsclientcert@kubernetescrd
              traefik.ingress.kubernetes.io/router.tls: "true"
        services:
          annotations:
            grpc:
              traefik.ingress.kubernetes.io/service.serversscheme: h2c
      

      Note:

      The global.ingress.serviceAnnotations settings are deprecated starting with version 1.1.0. Use the global.services.annotations settings instead.

      Traefik Helm chart port mapping configuration for The Things Stack (including both plain-text and TLS ports):

      deployment:
        kind: "Deployment"
        replicas: 1
      ports:
        web:
          redirections:
            to: websecure
            scheme: https
        grpc:
          protocol: "TCP"
          port: 1884
          expose:
            default: true
          exposedPort: 1884
        grpcsecure:
          protocol: "TCP"
          port: 8884
          expose:
            default: true
          exposedPort: 8884
        gtwmqttv2:
          protocol: "TCP"
          port: 1881
          expose:
            default: true
          exposedPort: 1881
        gtwmqttv2secure:
          protocol: "TCP"
          port: 8881
          expose:
            default: true
          exposedPort: 8881
        gtwmqttv3:
          protocol: "TCP"
          port: 1882
          expose:
            default: true
          exposedPort: 1882
        gtwmqttv3secure:
          protocol: "TCP"
          port: 8882
          expose:
            default: true
          exposedPort: 8882
        semtechws:
          protocol: "TCP"
          port: 1887
          expose:
            default: true
          exposedPort: 1887
        semtechwssecure:
          protocol: "TCP"
          port: 8887
          expose:
            default: true
          exposedPort: 8887
        appmqtt:
          protocol: "TCP"
          port: 1883
          expose:
            default: true
          exposedPort: 1883
        appmqttsecure:
          protocol: "TCP"
          port: 8883
          expose:
            default: true
          exposedPort: 8883
        ttigw:
          protocol: "TCP"
          port: 1889
          expose:
            default: true
          exposedPort: 1889
        ttigwsecure:
          protocol: "TCP"
          port: 8889
          expose:
            default: true
          exposedPort: 8889
        udp:
          protocol: "UDP"
          port: 1700
          expose:
            default: true
          exposedPort: 1700
      

      Traefik middleware for LoRa Basics™ Station buffering:

      apiVersion: traefik.io/v1alpha1
      kind: Middleware
      metadata:
        name: buffering
        namespace: <traefik-namespace>
      spec:
        buffering: {}
      

      Traefik Middleware for The Things Industries Gateway Protocol TLS client certificate passthrough:

      apiVersion: traefik.io/v1alpha1
      kind: Middleware
      metadata:
        name: traefik-passtlsclientcert
        namespace: <traefik-namespace>
      spec:
        passTLSClientCert:
          pem: true
      

      Traefik default TLS options for The Things Industries Gateway:

      apiVersion: traefik.io/v1alpha1
      kind: TLSOption
      metadata:
        name: default
        namespace: <traefik-namespace>
      spec:
        clientAuth:
          clientAuthType: RequestClientCert
      

      UDP Ingress Route for the UDP Packet Forwarder:

      Warning:

      The UDP Packet Forwarder requires session affinity to work properly. Traefik does not support session affinity for UDP. Session affinity can usually be set up on the Load Balancer of the cluster. We recommend using the newer LoRa Basics™ Station instead of the UDP Packet Forwarder.
      apiVersion: traefik.containo.us/v1alpha1
      kind: IngressRouteUDP
      metadata:
        name: tts-gs-udp-packet-forwarder
        namespace: tts # Set this to the namespace where TTS is deployed.
      spec:
        entryPoints:
          - udp
        routes:
        - services:
          - name: tts-gs # <helm-chart-release-name>-gs
            port: 1700
      

      TCP Ingress Route for MQTT application integration:

      apiVersion: traefik.io/v1alpha1
      kind: IngressRouteTCP
      metadata:
        name: tts-as-mqtt
        namespace: tts # Set this to the namespace where TTS is deployed.
      spec:
        entryPoints:
          - appmqtt
        routes:
        - match: HostSNI(`*`)
          services:
            - name: tts-as-mqtt # <helm-chart-release-name>-as-mqtt
              port: 1883
      ---
      apiVersion: traefik.io/v1alpha1
      kind: IngressRouteTCP
      metadata:
        name: tts-app-mqtt-secure
        namespace: tts # Set this to the namespace where TTS is deployed.
      spec:
        entryPoints:
          - appmqttsecure
        routes:
        - match: HostSNI(`*`)
          services:
            - name: tts-as-mqtt # <helm-chart-release-name>-as-mqtt
              port: 1883
        tls:
          secretName: ingress-tls-secret
      

      Ingress-Nginx Controller

      Warning:

      We strongly recommend against using Ingress-Nginx as the Kubernetes SIG for Network and Security announced its retirement.

      Example of an Ingress-Nginx Controller configuration. More info about the Helm chart can be found here.

      The Things Stack Helm chart ingress configuration:

      global:
        ingress:
          controller: "nginx"
          tls:
            secretName: "ingress-tls-cert"
          annotations:
            grpc:
              nginx.ingress.kubernetes.io/backend-protocol: GRPC
              nginx.ingress.kubernetes.io/use-http2: "true"
            http:
              nginx.ingress.kubernetes.io/backend-protocol: HTTP
              nginx.ingress.kubernetes.io/use-http2: "true"
            ttigw:
              nginx.ingress.kubernetes.io/backend-protocol: HTTP
              nginx.ingress.kubernetes.io/use-http2: "true"
            semtechws:
              nginx.ingress.kubernetes.io/backend-protocol: HTTP
              nginx.ingress.kubernetes.io/use-http2: "false"
            semtechcups: # new in v1.1.0 
              nginx.ingress.kubernetes.io/backend-protocol: HTTP
              nginx.ingress.kubernetes.io/use-http2: "false"
        services:
          annotations: {}
      

      Ingress-Nginx Helm chart port mapping configuration:

      Note:

      When using Ingress-Nginx, enable the TLS ports in the Helm chart (v0.0.13 and above).
      controller:
        config:
          use-http2: true
          strict-validate-path-type: false # This is needed to allow gRPC paths that contain dots.
          default-ssl-certificate: <tls-certificate-secret-namespace>/<tls-certificate-secret-name>
      tcp:
        # Plain-text ports. Not recommended for production usage.
        "1881": tts/the-things-stack-gs:1881 # <namespace>/<helm-chart-release-name>-gs:1881
        "1882": tts/the-things-stack-gs:1882
        "1883": tts/the-things-stack-as:1883
        "1887": tts/the-things-stack-gs:1887
        "1889": tts/the-things-stack-gs:1889
        # TLS ports.
        "8881": tts/the-things-stack-gs:8881
        "8882": tts/the-things-stack-gs:8882
        "8883": tts/the-things-stack-as:8883
        "8887": tts/the-things-stack-gs:8887
        "8889": tts/the-things-stack-gs:8889
      udp:
        "1700": tts/the-things-stack-gs:1700
      
      ← Prerequisites Preparation →

      On this page

      • Traefik
      • Ingress-Nginx Controller

      Sections

      Getting Started

      Concepts

      Cloud

      Enterprise

      Integrations

      API

      Hardware

      Sitemap

      View our Sitemap

      Contributing

      GitHub

      About Us

      The Things Industries

      Privacy Policy

      Cookie settings

      Cookie Settings

      We use cookies to enhance your experience, analyze site traffic and deliver personalized content. Read our Privacy Policy.

      Cookie categories