Configuration and Update Server (CUPS)

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.


  1. User account on The Things Enterprise Stack with rights to create gateways.
  2. 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.

Configure Gateway

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: https://<server-address>:443

The <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, e.g

CUPS Server Certificate / CUPS Trust

This is the CA certificate which secures your domain. A .pem file containing common certificates is available in the Root Certificates Reference.

Upload the .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.