Skip to main content

Gateways Configuration Guide

This tutorial guides you through the process of adding and configuring a gateways in The Things Stack.

Creating a New Gateway​

  1. On the Home tab, click Register gateway.
    • If you are on a different tab, click the blue + Add button in the top right and choose Add new gateway.

The Things Stack Home dashboard with the Register gateway button in the quick-action row

  1. You will be redirected to the gateway registration page.
    • TTS will first request the Gateway EUI (use RouterOS Gateway ID).
    • You can find the Gateway EUI printed on your physical gateway.

Register gateway page asking for the Gateway EUI, with a Continue without EUI option

  1. After entering the Gateway EUI, fill in the following fields:

    • Gateway ID ( Your chosen identifier for the device → example: test-geteway-001)
    • Gateway Name (Your chosen name for the device → example Test Geteways-001)
    • Frequency Plan → select Europe 868.1 MHz
    • (Optional) Label

  2. Check the box Require authenticated connection.

  3. Enable the following:

    • Generate API key for CUPS
    • Generate API key for LNS

  4. Click Register gateway.

Register gateway form with Gateway ID, name, Europe frequency plan, authenticated connection, and CUPS/LNS API key checkboxes

Downloading API Keys​

A window titled Download gateway API keys will appear.

  • Download both API keys (CUPS & LNS).
  • Store them in a secure and reliable location on your computer.
  • Do not share them with anyone.
info

These keys are required when configuring the gateway interfaces (see the documentation for your specific gateway under the LNS & CUPS section).

After downloading:

  • The window will close automatically, or
  • Click I have downloaded the keys.

Download gateway API keys dialog with Download LNS key and Download CUPS key buttons and the confirmation checkbox

Gateway Ready​

Your gateway is now ready to use, and you can begin connecting individual end devices.

Removing Gateway​

When deleting a gateway in The Things Stack, its Gateway ID is not fully removed from the server. Even though the gateway disappears from the console, the ID remains reserved in the backend.
This means it is not possible to create a new gateway with the same ID unless the ID is manually released.

Only a system administrator has the rights to free or purge the gateway ID from the server.
For regular users, the only available solution is to create the gateway again using a new, different ID.

Video Tutorial​

tip

If you need further assistance or a visual demonstration of the process described in this guide, consult the Video Guide.