> For the complete documentation index, see [llms.txt](https://docs.widgelix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.widgelix.com/lorawan-network-server/troubleshooting.md).

# Troubleshooting

Common LoRaWAN Network Server problems and a setup checklist.

| Problem                                  | Things to check                                                                                                                          |
| ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **LoRaWAN Server** is not in the sidebar | The role has no *LoRaWAN Server* menu access. Ask an administrator.                                                                      |
| **Activate** button is missing           | The role has no **Write** permission on the LoRaWAN module.                                                                              |
| Gateway stays offline                    | Gateway ID entered correctly? Packet forwarder pointed to the Widgelix network server? Gateway has internet access?                      |
| Device never shows **Last seen**         | Gateway online and in range? Correct region in the device profile? DevEUI correct?                                                       |
| Device cannot join (OTAA)                | JoinEUI and AppKey correct? NwkKey empty for LoRaWAN 1.0.x? Profile has OTAA on and the right MAC version?                               |
| Uplinks rejected after a device reset    | The device restarted its frame counter. Re-join (OTAA) or temporarily enable **Skip frame-counter check**.                               |
| No data on the asset dashboard           | Asset with the same DevEUI exists? Asset connectivity set to the Widgelix LoRaWAN Network Server? Decoder in the asset template correct? |
| Cannot add a gateway, profile or device  | Missing **Write** permission or entity-level restrictions.                                                                               |

## Setup checklist

* [ ] User has LoRaWAN Server menu access and Write permission
* [ ] Network server activated (status **Active**)
* [ ] Device profile(s) with correct region and MAC version
* [ ] Gateway(s) registered and online
* [ ] Device(s) registered with matching DevEUI, profile and keys
* [ ] Keys programmed identically on the physical devices
* [ ] Matching assets exist and receive data
