This is the reference for the gRPC and HTTP APIs that The Things Stack exposes.


The Things Stack is composed of a number of components. The core components Network Server, Application Server and Join Server follow the LoRaWAN Network Reference Model. The Things Stack also contains an Identity Server, Gateway Server, Console and Command-line Interface.


The Things Stack binary can be configured with many different options. Those options can be provided as command-line flags, environment variables or using a configuration file.

Email Templates

Email templates define the contents of the emails that The Things Stack sends to its users. They allow network operators to override the default contents of the emails with their own custom contents.

Frequency Plans

This reference contains Frequency Plans that are officially supported by The Things Stack. This list is populated from the lorawan-frequency-plans Github repository.

Deployments may also have custom frequency plans configured.


This reference contains common terms and definitions to help you find your way around The Things Stack.

Interoperability Repository

The Things Stack expects the root of interoperability repository to contain config.yml, which contains various interoperablity configuration options.


The Things Stack uses a port per protocol, with a TLS counterpart when applicable. Ports can be shared by multiple services using the same protocol, i.e. gRPC services sharing management, data and events services.

Root Certificates

This section contains links to common root SSL certificates used in The Things Stack, issued by trusted certificate authorities (CAs).

Web UI Branding

This reference gives details on how to customize the branding of the login pages and the Console.