Installation

Ignition 8.1 build

This page covers installing the Ignition 8.1 build (LoRaWAN-8.1.modl, minimum Ignition 8.1.33). For the Ignition 8.3 build with the web UI, see the current documentation.

Prerequisites

• Ignition 8.1.33 or higher (built against the 8.1.53 SDK; runs on any 8.1.33+ gateway)
• One or more LoRaWAN gateways speaking the Semtech Packet Forwarder UDP protocol
• Network connectivity between gateways and Ignition (inbound UDP, default port 1700)
• No required Ignition modules

Paid Module

The LoRaWAN module participates in Ignition licensing. It runs in trial mode until licensed; when the trial expires, the network layer is disabled (tags report Bad_TrialExpired quality and downlinks return HTTP 503). See Licensing.

Ignition Edge

On Ignition Edge, the module is capped at 50 devices. Attempting to register a 51st device raises an error, and any devices beyond the cap in a CSV import or restored config are skipped.

Download

Download LoRaWAN Module

Installation Steps

1. Log in to your Ignition Gateway web interface
2. Navigate to Config > Modules
3. Click Install or Upgrade a Module
4. Select the LoRaWAN-8.1.modl file
5. Review and accept the license agreement
6. The module installs automatically

Verification

After installation:

1. Verify the module appears in the modules list with Running status
2. Navigate to Config > LoRaWAN > Settings — the module's only configuration page
3. In the Designer, confirm the [LoRaWAN] tag provider is present under the tag browser

No web UI on 8.1

There is no Connections > LoRaWAN section on this build — see Configuration for how devices, gateways, and decoders are managed instead.

Network Requirements

Inbound (Gateways to Ignition)

The Ignition gateway must accept UDP traffic from LoRaWAN gateways:

Source	Protocol	Port	Bind Address	Description
LoRaWAN Gateways	UDP	1700 (default, configurable)	0.0.0.0 (default)	Semtech Packet Forwarder

Firewall Configuration

Ensure your firewall allows inbound UDP traffic on the configured port (default 1700) from all gateway IP addresses.

Restart Required

Changing the UDP port or bind address requires a gateway restart to take effect. See Configuration.

Gateway Configuration

Configure your LoRaWAN gateways to point to the Ignition server:

{
  "server_address": "your-ignition-server-ip",
  "serv_port_up": 1700,
  "serv_port_down": 1700
}

Compatible Gateways

The module works with any gateway using the Semtech Packet Forwarder UDP protocol.

Tag Provider

After installation, a managed tag provider [LoRaWAN] is created automatically:

[LoRaWAN]
├── _Meta/
│   ├── DeviceCount
│   ├── ActiveDeviceCount
│   ├── GatewayCount
│   └── ConnectedGatewayCount
├── Devices/
│   └── {DeviceName}/
└── Gateways/
    └── {GatewayName}/

See Per-Device Tags for the full structure.

Troubleshooting

Issue	Solution
Module not appearing	Restart the Ignition gateway and check logs
Settings page not visible	Clear browser cache and refresh; the page is at Config > LoRaWAN > Settings
Gateways not connecting	Check UDP port, firewall rules, and gateway configuration
[LoRaWAN] tags report Bad_TrialExpired	Module trial has expired; apply a license to restart the network layer
[LoRaWAN] tags not visible	Module may need a restart; check gateway logs