Getting Started Concepts The Things Stack Cloud The Things Stack Enterprise Integrations API Hardware
Get The Things Stack

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

Generic

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.

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.

Warning:
Until the release of v1.0.0, all versions are considered to be in the Alpha stage and are not suitable for production use. The Things Industries does not offer any guarantees on compatibility between the Alpha versions.
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

Kubernetes v1.21 and above
Chart v1.0.0 and below (alpha) [x]

Prerequisites

The following are required for The Things Stack on Kubernetes.
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.
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

The Things Stack Cloud

The Things Stack Enterprise

Integrations

API

Hardware

Sitemap

View our Sitemap

Contributing

GitHub

About Us

The Things Industries