Search

how to connect rak gateways to loriot via udp

LORIOT provides an easy-to-use software platform for building and managing scalable, secure, long-range IoT networks. This guide explains how to connect a RAK gateway to the LORIOT Network Server using the Semtech UDP Packet Forwarder protocol.

Prerequisites

Before starting, ensure you have the following items:

  • A RAK gateway running WisGateOS 2.0 or later

  • A LoRaWAN gateway that is connected to the Internet via Wi-Fi, Ethernet, or cellular.

  • A registered LORIOT account

Register the Gateway in LORIOT

1. Based on your deployment location, choose the appropriate LORIOT server cluster.

LORIOT server cluster options
Figure 1: LORIOT server cluster options
  1. Click LOG IN to access your account. If you don’t have an account yet, complete the registration form on the same page to create one.
LORIOT Web UI Registration Page
Figure 2: LORIOT web UI registration page

  1. In the left navigation menu, go to Networks.

LORIOT Networks Tab
Figure 3: LORIOT networks tab

  1. Click + New Network.

Add New Network
Figure 4: Add new network
  1. Fill in the required details, such as Name, Organization User Access, and Location, then click Create New Network to proceed.
Fill in Network Details
Figure 5: Fill in network details

 

  1. Click + Add Gateway.

Figure 6: Add your gateway

  1. Configure the gateway information:

  • On the platform selection screen, choose Packet Forwarder Semtech to indicate that your gateway will use the standard Semtech UDP protocol.
Choose Packet Forwarder Semtech
Figure 7: Choose Packet Forwarder Semtech
  • In the following form, provide your gateway’s MAC address and EUI.
Gateway MAC address and EUI
Figure 8: Gateway MAC address and EUI

  1. Click Register Packet Forwarder Semtech gateway to complete the registration.

Completed gateway registration in LORIOT
Figure 9: Completed gateway registration in LORIOT

Configure the Gateway

  1. Log in to the gateway's Web UI.
WisGate web UI login page
Figure 10: WisGate web UI login page
  1. Go to LoRa > Configuration, and set Work Mode to Packet forwarder.
Select Packet forwarder in the Work Mode field
Figure 11: Select Packet forwarder in the Work Mode field
🗒️
NOTE

Ensure that the configured frequency band matches the frequency plan selected in the LORIOT Console.

  1. In the Protocol field, select Semtech UDP GWMP Protocol from the dropdown.
Select Semtech UDP GWMP as the protocol
Figure 12: Select Semtech UDP GWMP as the protocol
  • Server address: e.g., us1.loriot.io
  • Server port (up/down): 1780
  1. Click Save changes to apply the configuration.

Verify the Gateway Status

After the gateway configuration, go back to the LORIOT Console. The gateway status will show Connected if it is online and sending packets.

Gateway connected status

Figure 13: Gateway connected status

Troubleshooting

PROBLEM

POSSIBLE CAUSE

SUGGESTED SOLUTION
The gateway does not appear as Connected in the LORIOT Console.
  • Incorrect Gateway EUI or MAC entered.
  • Server address or port misconfigured.
  • Gateway not connected to the internet.
  • Confirm that the EUI and MAC match those shown in the gateway’s Web UI or on the device label.
  • Verify that the server address is correct (e.g., us1.loriot.io) and that the port is set to 1780.
  • Make sure the gateway is connected to the internet via Ethernet, Wi-Fi, or cellular.
The gateway appears offline even though it has been configured.
  • Wrong protocol selected.
  • Firewall or NAT is blocking UDP traffic.
  • In the gateway Web UI, make sure that the protocol is set to Semtech UDP (GWMP).
  • Confirm that the UDP port 1780 is open for outbound traffic on your local network.
Changelog
  • Version 1.1 - Added UTM links
    • Date Published: 09/01/2025
  • Version 1 - How to Connect RAK Gateways to LORIOT via UDP
    • Date Published: 08/14/2025

Updated