Skip to main content

HOME CHANNEL

The server knows each client's IP address. Most homes and offices share one external IP through a router (NAT), so the server can group connections arriving from the same external IP. The channel the server provides automatically for such a group is the HOME CHANNEL.

A HOME CHANNEL is not identity verification or an authorization boundary. NAT, proxies, VPNs, and shared networks can make unrelated users appear under one address, and a changed connection path changes the group.

Usage​

Omit the channel name and keep #topic:

io.listen('#topic', (tag, ...args) => console.log(tag, args));
// Send after the receiver has subscribed:
io.signal('#topic');

Only subscribers to the exact tag within the same HOME CHANNEL receive it. channel#topic and channel are explicit channels, not HOME CHANNEL.

An EMPTY message calls JS handlers as handler(tag), so ...args is []; an explicit signal('#topic', null) is distinct. Arduino receives payloadType EMPTY and payloadSize 0; do not read payload bytes.

Grouping types​

The server groups connections by the address it observes. Clients connecting from outside the server's network share a HOME CHANNEL when their public IP is the same. Clients on the server's private network and clients running on the server itself form a separate private HOME CHANNEL, so the feature works on both home and cloud servers.

Devices on the server's private network or on the server itself form the private HOME CHANNEL; external devices are grouped by shared public IP

Uses​

  • Device discovery and notification: find devices at the same place without agreeing on a channel name. A web app opened at home finds the home devices; opened at the office, it finds the office devices.
  • Check-in detection: when a device that joins Wi-Fi automatically, or a phone's web app, connects to the server, other devices in the same HOME CHANNEL can notice the arrival.

Protected data and control commands still need authentication and authorization. For wire data, see payload formats.