This page guides you to connect The Things Indoor Gateway to The Things Stack.
The Things Indoor Gateway is an 8 Channel LoRaWAN gateway, whose technical specifications can be found in the official documentation.
- User account on The Things Stack with rights to create Gateways and API Keys.
- The gateway EUI. The EUI of the gateway is not the WiFi MAC address printed on the back of the gateway, but is derived from the first number that typically is of the form 58A0CBxxxxxx, printed on the top of the sticker below the QR code. For example, if that number is 58A0CB800BE7, insert FFFE after the first 6 characters to make it a 16 character Gateway EUI (e.g. 58A0CBFFFE800BE7).
The gateway EUI can later be found at the bottom in the WiFi setup screen.
- The WiFi password of the The Things Indoor Gateway, typically printed on the back of the gateway.
Claiming The Things Indoor Gateway
The Things Indoor Gateway is added to The Things Stack via a process called Gateway Claiming.
Warning:Do not register your TTIGs via the regular option of Adding Gateways.
Go to Gateways in the top menu, and click the Claim Gateway button on the upper right to reach the gateway claiming page.
Fill the Gateway EUI, the Claim authentication code (the WiFi Password from Prerequisites), the Gateway ID and choose the appropriate Frequency Plan.
Click Claim gateway to finish.
If your inputs are correct, a new gateway will be created and you will be redirected to the gateway overview page of your newly created gateway.
The following example claims and configures a gateway with EUI
00800000A00009EF and Gateway ID
gtw1 to the The Things Stack Community Edition
Please adapt the example for your specific case.
tti-lw-cli gateways claim 00800000A00009EF \ --authentication-code abcdef \ --target-gateway-id gtw1 --target-cups-uri https://eu1.cloud.thethings.network:443 \ --target-gateway-server-address eu1.cloud.thethings.network \ --target-frequency-plan-id EU_863_870 \ --user-id user1
For The Things Stack Cloud, you will also need to append the Tenant ID to
For example using
target-cups-uri would be
https://tenant1.eu1.cloud.thethings.industries:443 and the
target-gateway-server-address would become
Connecting The Things Indoor Gateway
Gateways Connected to Another LNS
Note:This is applicable if your gateway was previously connected to The Things Network v2.
If the The Things Indoor Gateway is currently connected to another LNS, do either of the following
- Wait up to 24 hrs (this is the default action for gateways that are not physically reachable). The Things Indoor Gateway connects to the server every 24 hours to check for new configuration.
- Unplug the power supply, wait for a few seconds and plug it back in. The Things Indoor Gateway now connects to the server to check for new configuration.
If your gateway has never been configured to any LNS, follow the steps below.
Keep the RESET button (small button at the back of the gateway next to the USB-C port) pressed for 5 seconds until the LED blinks rapidly from GREEN to RED and vice versa for a couple of times.
Hold the SETUP button (at the top of the gateway, next to the LED) for 10 seconds until the LED rapidly blinks RED.
The gateway now exposes a WiFi access point whose SSID is MINIHUB-xxxxxx, where
xxxxxx is the last 6 digits of the gateway EUI. The password for this network is same WiFi password from the Prerequisites.
After connecting to this network go to
192.168.4.1 using a web browser to access the WiFi config page.
Select the WiFi network by clicking the + button next to the desired network (and enter its password if it is a secure network).
Note:The Things Indoor Gateway does not support enterprise WiFi networks.
Click Save and Reboot to finish.
If your configuration is correct,
- The gateway will blink GREEN for a few seconds until it connects to the selected WiFi network.
- Then, it will blink from GREEN to RED and vice versa for a few seconds while it connects to the server and fetches the necessary configuration.
- Please allow 5-10 minutes for the gateway to pick up the new configuration.
If this is the first time your gateway is being powered on/connected to WiFi, it might pick up a new firmware depending on when it was last updated. This is indicated by alternating GREEN/RED blinks of the LED. Please leave the gateway powered on when this happens.
New in 3.14.1 You can also claim gateways that have been previously claimed or registered to The Things Stack.
For this, you need to authorize your gateways for claiming. This is currently only supported via the CLI.
Command-line interface only
The instructions below use the command-line interface (CLI).
$ ttn-lw-cli gateways claim authorize <gateway-id>
Now claim the gateway as described in the Claiming The Things Indoor Gateway section.
Once complete, make sure to unauthorize the gateway to prevent further claiming.
$ ttn-lw-cli gateways claim unauthorize <gateway-id>
Claim Authentication Code Mismatch
Double-check the EUI and the WiFi Password. Sometimes an
8 looks like a
3 or a
1 like an
0 like an
O, etc. Note that the
FFFE string has an
e at the end.
Gateway Not Authorized for Claiming
If you have already registered/claimed your The Things Indoor Gateway in The Things Stack cluster that you want to claim, check the section on claiming existing gateways.
Gateway with ID Already Exists
This means that either you or another user has already used the Gateway ID. Please choose another ID and try again.
Gateway shows status
Disconnected and the LED status is solid green. What do I do?
Reboot your The Things Indoor Gateway. If the gateway status is still
Disconnected after a reboot, try performing a factory reset and reconfiguring the gateway.
|Color(s)||Illumination Pattern||Operating Mode||Meaning|
|GREEN||Blinking (freq 1 sec)||GW||WiFi not connected (or trying to connect)|
|GREEN||Blinking (freq 1/4 sec)||GW||Connected to WiFi, establishing connection to LNS/configuring radio|
|GREEN||Solid||GW||Connected to WiFi, connected to LNS backend, listening for packets|
|GREEN/RED||Alternate Blinking (freq 1/4 sec)||CONF||Scanning WiFi networks, setting up Config AP|
|RED||Blinking (freq 1/4 sec)||CONF||Config AP active|
There are three possible button actions on the TTIG that are listed below.
- SETUP button pressed for 10s:
- Switch to CONF mode if in GW mode
- SETUP button pressed for 5s:
- Reboot if in CONF mode, do nothing in GW mode
- RESET button pressed for 5s:
- Factory reset (wipes out WiFi and LNS credentials, retains CUPS credentials)
It is possible to read debug messages of the gateway but it requires opening its casing.
Warning:Opening the casing may damage the gateway and/or void your warranty.
The casing needs to be first opened by unscrewing two screws found below the top and the bottom panel. Then, connect a 3.3V UART-USB Interface such as an FTDI to your computer. Connect the Rx (FTDI) to the Tx of the Gateway and ground pins.
Use a serial terminal (Ex:
PUTTY on Windows and
minicom on macOS/Linux) with a baudrate of 115200@8N to read the serial out. The connections are shown in the image below.
Operating behind a firewall
The following connections must be permitted in the firewall.
|IPv4||UDP||your DNS server(s)||53||DNS|