Files

T

dohertj2 fab35e8e7c Document Z-Wave JS and Zigbee2MQTT on Docker host; drop Raspberry Pi docs

- raspi_zwave.md -> zwave_zigbee.md: zwavejs + zigbee2mqtt containers, Z-Net G8 ports 2001/2002
- Remove obsolete migratezwave.md plan
- Add containers to docker.md, MQTT/Zigbee notes to ha.md, component entry to CLAUDE.md

2026-10-09 07:23:22 -04:00

3.8 KiB

Raw Permalink Blame History

Z-Wave & Zigbee Infrastructure

Architecture

Z-Wave: HA (10.100.0.40) --ws:3100--> Docker host (10.100.0.35) zwavejs     --tcp:2001--> Z-Net G8 (10.200.0.106) Z-Wave radio
Zigbee: HA Mosquitto (10.100.0.40:1883) <--mqtt-- Docker host zigbee2mqtt   --tcp:2002--> Z-Net G8 SmartStick ZB (USB)

Both radios live on the Z-Net G8; both controller apps run as containers on the Docker host, deployed by the Ansible playbook (~/playbook, roles zwavejs and zigbee2mqtt).

The Raspberry Pi (10.200.0.190) that previously hosted Z-Wave JS UI is gone.

Z-Net G8 (Z-Wave Controller)

Hostname: Z-Net-G8
IP: 10.200.0.106 (IOT_200, VLAN 200)
MAC: 02:53:ec:d0:de:dd
Manufacturer: HomeSeer Technologies
Role: Z-Wave radio controller (Node 1), serial-over-TCP on port 2001
Zigbee: HomeSeer SmartStick ZB plugged into the Z-Net's USB, exposed on port 2002 (2003 is for older Sonoff ZBDongle-E revisions). Requires Z-Net firmware ≥ 1.0.27 (running 1.0.27).
Web UI: http://10.200.0.106/

Z-Wave JS UI (container on the Docker host)

Host: Docker Server — ssh dohertj2@10.100.0.35
Container: zwavejs (zwavejs/zwave-js-ui:latest), restart unless-stopped, created 2026-07-03
Compose file: /opt/zwavejs/docker-compose.yml (templated by playbook role zwavejs)
Store/data: /opt/zwavejs/store → /usr/src/app/store (settings.json, nodes.json, backups/)
Network: traefik
Web UI: https://zwave.dohertylan.com (Traefik → port 8091, Authelia SSO; Z-Wave JS UI's own auth is disabled)
Z-Wave JS websocket: ws://10.100.0.35:3100 (host 3100 → container 3000)

Z-Wave JS Config

Serial port: tcp://10.200.0.106:2001 (Z-Net G8 over network)
Z-Wave region: 1 (US)
Server port: 3000 in container (published as 3100)

Home Assistant Integration

Integration: zwave_js
Connects to: ws://10.100.0.35:3100
Size: 25 devices, 296 entities (2026-10-09)
Node 1: HomeSeer Z-Wave Shield with External Antenna (Z-Net G8)
Two stale not_loaded config entries remain (an old "Z-Wave JS" entry and a Silicon Labs CP2102N USB serial entry)

Zigbee2MQTT (container on the Docker host)

Container: zigbee2mqtt (koenkk/zigbee2mqtt:latest, 2.14.2 at deploy), restart unless-stopped, deployed 2026-10-09
Playbook role: zigbee2mqtt — sudo ansible-playbook site.yml -i localhost, -c local --tags zigbee2mqtt --limit localhost from ~/playbook (Semaphore currently has no project configured)
Compose file: /opt/zigbee2mqtt/docker-compose.yml
Data: /opt/zigbee2mqtt/data → /app/data (configuration.yaml holds the generated network key — back it up; coordinator_backup.json)
Config ownership: configuration.yaml is seeded once by Ansible (never overwritten); MQTT, serial and frontend settings are enforced by ZIGBEE2MQTT_CONFIG_* env vars in the compose file
Web UI: https://zigbee.dohertylan.com (Traefik → port 8080, Authelia SSO)
Coordinator: tcp://10.200.0.106:2002, adapter ember, EmberZNet 7.4.3, IEEE 0x8c8b48fffe2dd481
Network: channel 25, PAN ID 64462 (0xFBCE) — new network formed 2026-10-09; all devices must be (re)paired
MQTT: HA's Mosquitto broker add-on at mqtt://10.100.0.40:1883, base topic zigbee2mqtt, HA discovery enabled
- User: zigbee2mqtt / Password: Aywm6DjOR3bfSo9c7zDoWDxX (login in the Mosquitto add-on options; also in the playbook role defaults)

Pairing devices

Turn on Permit join in the Zigbee2MQTT web UI (or the switch.zigbee2mqtt_bridge_permit_join entity in HA), then reset/pair the device. It appears in HA automatically via MQTT discovery.

Notes

Z-Net G8 is on the IoT VLAN; the Docker host reaches it cross-VLAN (or via its IOT_200 interface 10.200.0.35)
Tracked by Unifi as device_tracker.z_net_g8

3.8 KiB Raw Permalink Blame History