> 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/gateways.md).

# Gateways

Register LoRaWAN gateways and monitor their status.

Gateways are the LoRaWAN base stations. They receive radio packets from end devices and forward them to the network server.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FddxHdTxXTX2YgTuI6Obr%2Fgateways-empty.png?alt=media&amp;token=df7a683c-02fb-4800-9020-76a399701a68" alt="Gateways tab"><figcaption><p>Gateways tab (empty state)</p></figcaption></figure>

## The Gateways tab

* **Search by name or ID**.
* **Online / offline** counters for all gateways.
* **Map**: shows gateways that have a location on a map.
* **Fit screen / Expand** and **Refresh**.

The list shows each gateway's **Gateway ID** (EUI), **Name**, **Description** and **Last seen** (last time it connected to the network server). If there are no gateways yet, the tab shows *No gateways yet* with an **+ Add gateway** button.

## Add a gateway

1. Click **+ Add gateway**.
2. Fill in the form:

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FXduE7cLBBvIlgTOA1fvX%2Fadd-gateway.png?alt=media&amp;token=fd629bf5-1f2d-4f1b-848b-0b415c8fbe4d" alt="Add gateway dialog" width="420"><figcaption><p>Add gateway (demo values)</p></figcaption></figure>

| Field           | Required | Description                                                                                              |
| --------------- | -------- | -------------------------------------------------------------------------------------------------------- |
| **Gateway ID**  | Yes      | 16 hex characters (EUI-64) as printed on the gateway, e.g. `A84041FFFE1B7C22`. Cannot be changed later.  |
| **Name**        | Yes      | Descriptive name, e.g. `Rooftop Gateway`.                                                                |
| **Description** | No       | Optional notes, e.g. installation details.                                                               |
| **Location**    | No       | Turn on to show the gateway on the map. Enter **Latitude** and **Longitude** or click **Select on map**. |

3. Click **Add gateway**.

## Connect the gateway

Configure the gateway's **packet forwarder** to send traffic to the Widgelix network server, using the server address provided for your organization and the same frequency plan as your device profiles. Once the gateway connects, its **Last seen** time updates and it is counted as online.

Default GreenMesh LoRaWAN Server configuration:

&#x20; \- Address: [lorawan.gminternal.com](http://lorawan.gminternal.com/)\
&#x20; \- Uplink Port: 1700\
&#x20; \- Downlink Port: 1700

{% hint style="info" %}
Adding a location helps with coverage planning and lets you see the gateway on the map.
{% endhint %}

## Edit or delete a gateway

* Use the **edit** (pencil) icon to change the name, description or location. The Gateway ID cannot be changed.
* Use the **delete** (bin) icon to remove the gateway. This cannot be undone.

Editing requires **Write** and deleting requires **Delete** permission on the LoRaWAN module.

## Monitoring gateways

| Last seen   | Meaning                                                 |
| ----------- | ------------------------------------------------------- |
| Recent time | Gateway is online and forwarding traffic.               |
| Empty (—)   | Gateway has never connected.                            |
| Old time    | Gateway is offline or has lost its backhaul connection. |

To be notified automatically, create an action with **Gateway connectivity alert → Gateway goes offline** (and a second one for *Gateway goes online*). Combine it with [Action Dependencies](https://docs.widgelix.com/actions-formerly-rule-engine/action-dependencies.md) so that asset-offline alerts are suppressed while their gateway is down.
