LNS establishes a data connection between a LoRa Basics™ Station and The Things Stack. This page contains information about connecting your gateway to The Things Stack using the LoRaWAN® Network Server (LNS) protocol.
Note:The LNS protocol is required for sending and receiving LoRaWAN data with LoRa Basics™ Station , while the CUPS protocol is not. However, configuring CUPS will automatically retrieve LNS credentials and configure LNS on your gateway, so there is no need to configure both.
- User account on The Things Stack with rights to create gateways.
- A gateway which support LoRa Basics™ Station .
Create a Gateway
To connect a gateway using the LNS protocol, you must first add the gateway in The Things Stack. This can be done either in the console, or via the command line. See instructions for Adding Gateways.
Create an API Key
LNS requires an API Key with the following rights:
- Link as Gateway to a Gateway Server for traffic exchange, i.e. write uplink and read downlink
To create an API key for your gateway, follow instructions for Creating a Gateway API key in Adding Gateways.
All LoRa Basics™ Station gateways support the following configuration options. Consult your gateway documentation for more information about configuring your specific gateway.
LNS Server Address
The server address is the network endpoint of The Things Stack LNS. It is a combination of the protocol (wss), the server address, and the port:
Enter the following in your gateway as the LNS Server Address:
<server-address>is the address of The Things Stack. If you followed the Getting Started guide this is the same as what you use instead of
LNS Server Certificate / LNS Trust
.pem file in your gateway as the LNS Server Certificate / LNS Trust.
LNS Key File
This is a file which The Things Stack uses to verify the identity of your gateway.
Use the following command to create a file called
"your-lns-api-key" with the LNS API key you created above.
$ export LNS_KEY="your-lns-api-key" $ echo "Authorization: Bearer $LNS_KEY" | perl -p -e 's/\r\n|\n|\r/\r\n/g' > lns.key
Note:The above command creates a file called
lns.key, terminated with a Carriage Return Line Feed (
0x0D0A) character. Upload this file in your gateway as the LNS key.