This guide explains how to connect gateways running a Semtech packet forwarder to Canopy NOC using the Kudzu UDP proxy. The proxy transparently forwards traffic between your gateways and your backend server while extracting metadata for the analytics platform.

Before you begin#

• Confirm you have an active Canopy NOC account with permission to manage integrations.
• Have access to your gateway configuration (web interface, SSH, or local configuration files).
• Know the address and port of your current LoRaWAN backend server.

Step 1 – Configure the proxy integration in Canopy NOC#

1. Open the sidebar and navigate to Configuration > LNS Integrations.
2. Click Add Integration and select Semtech UDP Proxy.
3. Configure the proxy settings:
   • Proxy to – the address of your backend server (default: router.kudzu.gr).
   • Up port – the port for uplink traffic forwarding (default: 1700).
   • Down port – the port for downlink traffic forwarding (default: 1700).
4. Click Save.

Step 2 – Reconfigure your gateways#

Point each gateway to the Kudzu proxy address so traffic routes through the proxy on its way to your backend.

If your gateway has a web-based administration interface that allows changing the forwarding server address, set it to router.kudzu.gr and restart the packet forwarder. No further steps are needed.

If your gateway requires manual configuration file editing, follow the steps below.

2a. Locate the configuration file#

Find the local_conf.json file on your gateway. The location varies by gateway model but is typically under /etc/lora/ or a similar path.

2b. Update the server address#

Edit the gateway_conf section to point to the proxy:

"gateway_conf": {
  "gateway_ID": "<your-gateway-eui>",
  "server_address": "router.kudzu.gr",
  "serv_port_up": 1700,
  "serv_port_down": 1700
}

2c. Restart the packet forwarder#

Restart the packet forwarder service on the gateway to apply the changes.

Step 3 – Verify data flow#

1. Return to Canopy NOC and navigate to Configuration > LNS Integrations.
2. Click the eye icon on the Semtech UDP Proxy integration.
3. Confirm that log entries show incoming traffic and that the Last activity timestamp updates.

What to do next#

• Manage Investigation Dashboards to import diagnostic views.
• Review the Metrics Dashboard for KPI summaries.