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
          • Preparation
          • Configuration
          • Install Charts
          • Monitoring
          • Troubleshooting
          • Database Migrations
        • Azure
      • Docker
      • The Things Join Server
      • Manage The Things Stack
      Enterprise

      Generic

      Updated 23 June 2026 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 Things Stack is packaged as a Helm Chart to be run on Kubernetes Clusters. The Things Stack Helm charts are packaged and distributed as OCI packages and are published to Docker Hub.

      This guide helps the user to install and configure The Things Stack on a Kubernetes cluster.

      Warning:

      Operating The Things Stack on a Kubernetes cluster is only meant for advanced users with sufficient experience with the chosen infrastructure platform and with Kubernetes.

      Note:

      Make sure to follow each section of this guide in the same order as it is written without skipping any steps.

      UDP Gateway Support

      UDP gateways require connection stickiness in order to continue communicating with Gateway Server instances when they get recreated or when the nodes on which Gateway Servers are running are replaced. The most straightforward way to do this is to connect UDP gateways directly to the Gateway Server service via an external Load Balancer. This depends on the settings of the external Load Balancer that is used. The implementation details are specific to the external environment and is hence out of scope for this documentation. Please check the documentation of the Load Balancer and run tests to ensure that gateway communication is not lost on server updates.

      Kubernetes Version Support

      The Things Stack Helm chart versions v1.x and below support Kubernetes v1.21 and above.

      Starting with The Things Stack Helm chart v2.0.0, Kubernetes v1.27 or above is required, because the chart’s PodDisruptionBudgets use the unhealthyPodEvictionPolicy field, which is only available from Kubernetes v1.27 onwards.

      Prerequisites

      The following are required for The Things Stack on Kubernetes. These prerequisites may be provisioned through various methods depending on the infrastructure specifics and it is the responsibility of the cluster operator to ensure they are correctly set up to be used reliably with the The Things Stack Helm chart.
      Read

      Preparation

      The Things Stack requires a few secret values to be configured. In this section, we show how to generate them and store them for further use.
      Read

      Configuration

      The Things Stack Helm chart is configured using yaml files. This guide assumes that these fields are saved in a <deployment>.values.yaml file and used for deployment/updates.
      Read

      Install Charts

      The Things Stack Helm charts are packaged and distributed as OCI packages and are published to Docker Hub. You can also find information about the Helm chart on artifacthub.io. Use the following steps to install the chart.
      Read

      Monitoring

      The Things Stack exposes Prometheus metrics at the /metrics endpoint. This route is protected by Basic Auth with username metrics and password global.http.metrics.password. Exposure of the endpoint is controlled by global.http.metrics.enable (default true).
      Read

      Troubleshooting

      This guide contains general troubleshooting information.
      Read

      Database Migrations

      The Things Stack database schema is managed between minor versions using database migrations. User are informed of required migrations for each version via the Release Notes. It’s mandatory to run required database migrations for The Things Stack to function properly. This page describes the steps for performing database operations on a The Things Stack Kubernetes Cluster.
      Read
      ← Kubernetes Prerequisites →

      On this page

      • UDP Gateway Support
      • Kubernetes Version Support

      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