LoRa Basics™ Station can regularly connect to a Configuration and Update Server (CUPS) server to check for configuration and software updates. This page contains information about connecting your gateway to The Things Enterprise Stack to support remote management via the CUPS Protocol.
CUPS is not required for sending and receiving LoRaWAN data, but it can greatly simplify the management of gateways.
- User account on The Things Enterprise Stack with rights to create gateways.
- A gateway which supports LoRa Basics™ Station.
Create a Gateway
To connect a gateway using the CUPS protocol, you must first add the gateway in The Things Enterprise Stack . This can be done either in the console, or via the command line. See instructions for Adding Gateways.
Create an API Key
CUPS requires an API key for your gateway with the following rights:
- View gateway information
- Edit basic gateway settings
To create an API key for your gateway, follow instructions for Creating a Gateway API key in Adding Gateways.
Gateway configuration menus differ depending on the manufacturer, but all LoRa Basics™ Station gateways support the following configuration options. Consult your gateway documentation for more information about configuring your specific gateway.
CUPS Server Address
The server address is the network endpoint of The Things Enterprise Stack CUPS. It is a combination of the protocol (https), the server address, and the port:
Enter the following in your gateway as CUPS Server Address:
<server-address>is the address of The Things Enterprise Stack . If you followed the Getting Started guide this is the same as what you use instead of
CUPS Server Certificate / CUPS Trust
.pem file in your gateway as the CUPS Server Certificate / CUPS Trust.
CUPS Key File
This is a file which The Things Enterprise Stack uses to verify the identity of your gateway.
Use the following command to create a file called
cups.key with the
<gateway-api-key> you created above.
echo "Authorization: Bearer <gateway-api-key>" | perl -p -e 's/\r\n|\n|\r/\r\n/g' > cups.key
The above command creates a file called
cups.key, terminated with a Carriage Return Line Feed (
0x0D0A) character. Upload this file in your gateway as the CUPS key.