The Remote Gateway driver creates a proxy/replica of a gateway running on another Weble device. It connects to a remote Weble gateway over the network (HTTP/HTTPS via WebSocket) and synchronizes all addresses bidirectionally — values written locally are forwarded to the remote gateway, and values changing on the remote side are reflected locally.
This is essential for:
- Multi-site integration — access data from a remote building's gateway (connected via VPN) as if it were a local gateway. Route remote Modbus, BACnet, or M-Bus data into the local system.
- Central monitoring — aggregate data from multiple remote gateways into a single central gateway for unified dashboards and reporting.
- Redundancy — replicate critical gateway data to a secondary device.
- Protocol bridging across sites — route a remote site's Modbus registers into the local BACnet server, or forward remote sensor data to the local MQTT cloud connection.
¶ 1. Getting started
¶ 1.1 Prerequisites
- The remote Weble device must be reachable over the network (LAN, VPN, or internet).
- A user account on the remote device with access to the target gateway.
- The remote gateway must be running (connected state).
¶ 1.2 Gateway configuration
- Create a new gateway and select the Remote Gateway driver.
- Enter the URL of the remote Weble device (e.g.
http://192.168.1.99:8080orhttps://remote.example.com). - Enter the Username and Password for the remote device.
- Click the search button next to the Remote Gateway field — the driver connects to the remote device and lists all available gateways.
- Select the remote gateway you want to replicate.
¶ 1.3 How synchronization works
Once the gateway is started:
- The driver authenticates with the remote Weble device via the web API.
- It establishes a WebSocket connection for real-time data exchange.
- All addresses from the remote gateway are imported as local addresses.
- Value changes on either side are synchronized in real-time via the WebSocket.
- Reads and writes are transparently forwarded to the remote gateway.
The local gateway appears and behaves exactly like the remote one — same addresses, same values, same driver type. Routes can be created to/from the remote addresses just like any local address.
¶ 2. Gateway parameters
| Label | JSON Key | Description |
|---|---|---|
| Name | name | A descriptive name for this remote gateway instance. |
| Cluster ID | cluster | Cluster identifier. |
| Description | description | Optional description. |
| URL | url | URL of the remote Weble device's web server (e.g. http://192.168.1.99:8080, https://remote.example.com). |
| Username | username | Login username on the remote device. |
| Password | password | Login password on the remote device. |
| Remote Gateway | gateway | The remote gateway to replicate. Click the search button to list available gateways on the remote device. |
| Push initial values | pushInitialValues | If enabled, the local gateway sends its current values to the remote gateway at connection — acting as the master. Useful when the local side has the authoritative data. |
| Ignore initial values | ignoreInitialValues | If enabled, initial values received from the remote gateway at connection are ignored. Only subsequent changes are synchronized. |
¶ 2.1 Gateway JSON example
{
"url": "https://192.168.1.99",
"username": "admin",
"password": "password",
"gateway": "remote-gateway-id",
"pushInitialValues": false,
"ignoreInitialValues": false
}
¶ 3. Addresses
The Remote Gateway driver imports all addresses from the remote gateway automatically. The addresses keep the same names, descriptions, and types as on the remote side.
For example, if the remote gateway is a Modbus master with addresses %M1, %M2, %M3, the local remote gateway will have the exact same addresses with synchronized values.
Addresses cannot be manually inserted or removed — they are fully managed by the synchronization.
¶ 3.1 Address properties
| Property | Value |
|---|---|
| Readable | Yes (forwarded to remote gateway) |
| Writable | Yes (forwarded to remote gateway) |
| Routable | Yes |
| Loggable | Yes |