gandalf/secubox-openwrt
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
d18222dec8
secubox-openwrt/package/secubox/luci-app-zigbee2mqtt
History
CyberMind-FR e7c9411d79 feat: Release v0.8.2 - Admin Control Center, Documentation Mirror & Docker Automation 
This release adds major new features for SecuBox management and deployment:

## New Features

### 1. LuCI Admin Control Center (luci-app-secubox-admin)
- Unified admin dashboard for managing all SecuBox appstore plugins
- **Control Panel**: Real-time stats, system health, alerts, quick actions
- **Apps Manager**: Browse catalog, install/remove apps with search & filtering
- **App Settings**: Per-app configuration, start/stop controls
- **System Health**: Live monitoring (CPU, RAM, disk) with auto-refresh
- **System Logs**: Centralized log viewer with download capability
- Fully integrated with existing RPCD backend (luci.secubox)
- Mobile-responsive design with polished UI components

### 2. Documentation Mirror in SecuBox Bonus
- Integrated complete development documentation into luci-app-secubox-bonus
- 64+ documentation files now available offline at /luci-static/secubox/docs/
- Beautiful landing page (index-main.html) with 4 sections:
  - Development guides & references
  - Live module demos
  - Tutorials & blog posts
  - Marketing campaign pages
- Accessible locally on router without internet connection

### 3. Automated Docker Plugin Installation
- Enhanced secubox-appstore CLI with full Docker automation
- One-click installation from web UI now fully automated:
  - Auto-detects Docker runtime from catalog
  - Discovers and executes control scripts (*ctl install)
  - Pulls Docker images automatically
  - Creates directories and configures UCI
  - Enables init services
- No manual CLI steps required for Docker apps
- Works for all Docker apps: AdGuard Home, Mail-in-a-Box, Nextcloud, etc.

### 4. Mail-in-a-Box Plugin
- New Docker-based email server plugin (secubox-app-mailinabox)
- Complete package with:
  - UCI configuration (8 port mappings, feature flags)
  - Control script (mailinaboxctl) with install/check/update/status/logs
  - Procd init script with auto-restart
  - Catalog manifest (category: hosting, maturity: beta)
- Network mode: host (required for mail server)
- Persistent storage: mail, SSL, data, DNS volumes

## Improvements

### Build System
- Updated local-build.sh to include luci-app-* packages from package/secubox/
- Now automatically discovers and builds luci-app-secubox-admin and similar packages
- Fixed Makefile include paths for feed structure

### Package Releases
- Incremented PKG_RELEASE for all 31 SecuBox packages
- Ensures clean upgrade path from previous versions

### Catalog Updates
- Mail-in-a-Box entry moved from "productivity" to "hosting" category
- Status changed to "beta" reflecting community Docker image maturity
- Storage requirement increased: 1024MB → 2048MB
- Added port 25 accessibility note

## Files Changed

### New Packages (2)
- package/secubox/luci-app-secubox-admin/ (12 files)
- package/secubox/secubox-app-mailinabox/ (4 files)

### Enhanced Packages (1)
- package/secubox/luci-app-secubox-bonus/ (65 new docs files)

### Modified Core (3)
- package/secubox/secubox-core/root/usr/sbin/secubox-appstore
- package/secubox/secubox-core/root/usr/share/secubox/catalog.json
- secubox-tools/local-build.sh

### All Makefiles (31 packages)
- Incremented PKG_RELEASE for clean upgrade path

## Technical Details

**Admin Control Center Architecture:**
- Frontend: 5 views (dashboard, apps, settings, health, logs)
- API: Wrapper around luci.secubox RPCD methods
- Components: Reusable UI library (cards, badges, alerts, loaders)
- Styling: Common + admin-specific CSS with responsive design
- Auto-refresh: Polling for live updates (5-30s intervals)

**Docker Automation Flow:**
```
Web UI → RPCD → secubox-appstore CLI → opkg install → *ctl install →
docker pull → directories → UCI config → init enable → ✓ Ready
```

**Access Points:**
- Admin Control: http://router/cgi-bin/luci/admin/secubox/admin/
- Documentation: http://router/luci-static/secubox/index-main.html
- Demos: http://router/luci-static/secubox/demo-*.html

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-04 08:29:31 +01:00
..
htdocs/luci-static/resources feat(structure): reorganize luci-app packages into package/secubox/ + appstore migration 2026-01-01 14:59:38 +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(structure): reorganize luci-app packages into package/secubox/ + appstore migration 2026-01-01 14:59:38 +01:00
Makefile feat: Release v0.8.2 - Admin Control Center, Documentation Mirror & Docker Automation 2026-01-04 08:29:31 +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