ChirpStack
Setup the infrastructure
To setup a complete ChirpStack stack, please refer to the official documentation.
Register the gateway in the ChirpStack server
Once the server is running, register the gateway from the ChirpStack GUI.
Setup the ChirpStack Gateway Bridge
With ChirpStack, the gateway will communicate with a single software component: the ChirpStack Gateway Bridge.
ChirpStack offers two possibilities:
- Running the Gateway Bridge on the gateway
- Running the Gateway Bridge on the server
We recommend running the Bridge on the gateway directly. This guide proposes this solution. If you want to run the Bridge on the server, please use the Wifx Packet Forwarder configuration and refer to the ChirpStack documentation.
Activate the bridge
You can now connect to the gateway to enable the ChirpStack gateway bridge as the active forwarder. It is already installed on your gateway.
- On the LoRa Settings page, on the
FORWARDER
tab, use the top right edit button. - In the “Change forwarder” popup, select the ChirpStack Gateway Bridge and press Apply.

Now that the ChirpStack Gateway Bridge is the active forwarder, you can see his two configuration sections:
- Bridge configuration
- Backend configuration


setting active forwarder to 'chirpstack-gateway-bridge'... done
Configure the bridge
Backend and frontend
The ChirpStack Gateway Bridge, the front-end, does not access the hardware directly, instead it interacts with a packet forwarder on the gateway, the back-end.
The default configuration of the LORIX already connects the back-end to the front-end through the port 1700.
About localhost
The default address for the back-end and the front-end to communicate is set to 127.0.0.1. This address is called 'localhost' (or loopback address) and is assigned by default in any device. Keeping this address will always make the back-end and the front-end communicate internally on the gateway only.
Configure the front-end
Use the edit button on the right in the "Bridge configuration" section.
In the "Integration configuration" > [integration.mqtt.auth.generic] section, update the server
, username
, and password
fields with the address of your network server and the credentials configured on the server and save the configuration.
Example
For advanced configuration, please refer to the the ChirpStack documentation.
The bridge configuration is stored in the /etc/opt/chirpstack-gateway-bridge/chirpstack-gateway-bridge.toml file. You can edit the file with:
Configure the back-end
Use the edit button on the right in the "Backend configuration" section.
You can update the Gateway ID if needed, but by default it's already specific to each gateway.
For advanced configuration, please refer to the the Wifx Packet Forwarder documentation.
The back-end configuration is stored in the /etc/opt/udp-packet-forwarder/gateway/chirpstack-gateway-bridge folder.
As for the Wifx Packet Forwarder, the configuration is the merge of two files :
- gateway_global_conf.json
- gateway_local_conf.json
You can edit the file with:
Start the bridge
Press the Start
button
You can Start the forwarder using the manager with :
ChirpStack Gateway Bridge forwarder has been started
The bridge will connect to the server and you will start seeing the LoRa traffic in the ChirpStack dashboard.