zwave-js

Installation
SKILL.md

Identity

  • Service name: zwavejs2mqtt (systemd) or Docker container zwavejs2mqtt / zwave-js-ui
  • Project name: zwavejs2mqtt and zwave-js-ui are the same project; zwave-js-ui is the current name
  • Logs: journalctl -u zwavejs2mqtt -f (systemd) or docker logs -f zwavejs2mqtt
  • Web UI: http://<host>:8091 (built-in; always enabled unlike Zigbee2MQTT)
  • Config: /opt/zwavejs2mqtt/store/ (bare metal) or Docker volume mapped to /usr/src/app/store/
  • Key config files: store/settings.json (main config), store/zwcfg.xml (Z-Wave network cache)
  • Serial device: /dev/ttyUSB0, /dev/ttyACM0 — use /dev/serial/by-id/... for stability
  • Depends on: Mosquitto (or any MQTT broker) — must be running before zwavejs2mqtt starts
  • Install: docker run zwavejs/zwave-js-ui or bare-metal Node.js service
  • User: must be in dialout group to access the serial device

Key Operations

Operation Method
Check service status systemctl status zwavejs2mqtt or docker ps
Follow logs live journalctl -u zwavejs2mqtt -f or docker logs -f zwavejs2mqtt
Related skills
Installs
1
GitHub Stars
5
First Seen
Mar 18, 2026