The gateways in the local network can be discovered in various ways.

Discovery via Internet


This returns a JSON array of all known gateways in the local network.

If both the gateway and the application have access to the Internet, discovery via the Internet is the easiest way to find the gateway.


        "id": "E0:69:78:58:22:A4:32:CE",
        "internalipaddress": "",
        "internalport": "8080",
        "macaddress": "E0:69:78:58:22:A4:32:CE",
        "name": "RaspBee GW"


For webapps this is the only way to automatically discover the gateway.

By visiting a list of all gateways in the local network will be displayed.

Discovery via UPnP

Another method to find the gateway is UPnP discovery via UDP sockets.

The main advantage compared to the internet discovery is that no internet is needed at all.


The discovery might not work as expected if in the local network beside the main router also bridges are used, which might prevent UDP broadcasts to reach the whole network.

Discovery via nmap

Nmap is an open source command-line network scanner which is available for all major platforms. Since the gateway runs a SSH deamon at port 22 it is easy to find it in the local network.

$ nmap -p 22 -T5 -n -min-parallelism 100 --open

Replace the with your subnetwork for example


Starting Nmap 6.25 ( ) at 2013-07-01 13:04 CEST
Nmap scan report for
Host is up (0.00081s latency).
22/tcp open  ssh