gandalf/secubox-openwrt
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1ab19cb778
secubox-openwrt/package/secubox/luci-app-zigbee2mqtt
History
CyberMind-FR c5d40cf464 feat(zigbee2mqtt): Rewrite from Docker to LXC Alpine container 
Replace Docker-based zigbee2mqtt with a KISS LXC approach using Alpine
Linux container with Node.js + zigbee2mqtt, matching the HAProxy LXC
pattern. Adds USB serial passthrough for Sonoff Dongle Lite MG21.

- zigbee2mqttctl: Full LXC lifecycle (install, update, check, shell)
- RPCD: LXC diagnostics (lxc, cp210x, serial, container, service)
- api.js: Fix callApply missing params (payload was silently dropped)
- overview.js: Match new LXC diagnostics, fix applyConfig call
- Makefiles: Replace +dockerd +docker +containerd with +lxc +kmod-usb-serial-cp210x

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-04 18:32:57 +01:00
..
htdocs/luci-static/resources feat(zigbee2mqtt): Rewrite from Docker to LXC Alpine container 2026-02-04 18:32:57 +01:00
luasrc/controller/secubox feat(structure): reorganize luci-app packages into package/secubox/ + appstore migration 2026-01-01 14:59:38 +01:00
root/usr feat(zigbee2mqtt): Rewrite from Docker to LXC Alpine container 2026-02-04 18:32:57 +01:00
Makefile feat(zigbee2mqtt): Rewrite from Docker to LXC Alpine container 2026-02-04 18:32:57 +01:00
README.md feat(structure): reorganize luci-app packages into package/secubox/ + appstore migration 2026-01-01 14:59:38 +01:00

README.md

LuCI App – Zigbee2MQTT

Version: 1.0.0
Last Updated: 2025-12-28
Status: Active

LuCI interface for managing the Docker-based Zigbee2MQTT service packaged in secubox-app-zigbee2mqtt.

Features

  • Displays service/container status, enablement, and quick actions (start/stop/restart/update).
  • Runs prerequisite checks and full Docker installation (dockerd/containerd/image pull) via LuCI buttons.
  • Provides a form to edit /etc/config/zigbee2mqtt (serial port, MQTT host, credentials, base topic, frontend port, channel, data path, docker image, timezone).
  • Streams Docker logs directly in LuCI.
  • Uses SecuBox design system and RPCD backend (luci.zigbee2mqtt).

Requirements

  • secubox-app-zigbee2mqtt package installed (provides CLI + procd service).
  • Docker runtime (dockerd, docker, containerd) available on the router.
  • Zigbee coordinator connected (e.g., /dev/ttyACM0).

Installation

opkg update
opkg install secubox-app-zigbee2mqtt luci-app-zigbee2mqtt

Access via LuCI: Services → SecuBox → Zigbee2MQTT.

Files

Path Purpose
htdocs/luci-static/resources/view/zigbee2mqtt/overview.js Main LuCI view.
htdocs/luci-static/resources/zigbee2mqtt/api.js RPC bindings.
root/usr/libexec/rpcd/luci.zigbee2mqtt RPC backend interacting with UCI and zigbee2mqttctl.
root/usr/share/luci/menu.d/luci-app-zigbee2mqtt.json Menu entry.
root/usr/share/rpcd/acl.d/luci-app-zigbee2mqtt.json ACL defaults.

RPC Methods

  • status – Return UCI config, service enable/running state, Docker container list.
  • apply – Update UCI fields, commit, and restart the service.
  • logs – Tail container logs.
  • control – Start/stop/restart service via init script.
  • update – Pull latest image and restart.

Development Notes

  • Follow SecuBox design tokens (see DOCS/DEVELOPMENT-GUIDELINES.md).
  • Keep RPC filenames aligned with ubus object name (luci.zigbee2mqtt).
  • Validate with ./secubox-tools/validate-modules.sh.

Documentation