mirror of
https://github.com/MarekWo/mc-webui.git
synced 2026-05-03 12:02:34 +02:00
710f69c350
Integrate meshcore library's BLE connection (via bleak) as a third transport option alongside serial and TCP. Priority: BLE > TCP > Serial. Config: MC_BLE_ADDRESS and MC_BLE_PIN environment variables. Docker: bluez/dbus packages, NET_ADMIN cap, D-Bus socket mount. UI: transport type badge in navbar, transport_type in /api/status. Watchdog: skip USB reset for BLE connections (same as TCP). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
mc-webui Container Watchdog
The watchdog service is a utility designed to run on the host machine running the Docker containers for the mc-webui project. Its primary purpose is to continuously monitor the health of the application's containers, specifically the mc-webui container, which handles the physical connection to the LoRa device (like Heltec V3 or V4).
Key Capabilities
- Automated Restarts: If a container becomes
unhealthy, stops, or reports device connection issues in its logs, the watchdog automatically restarts it to restore service without human intervention. - Hardware USB Bus Reset: If the
mc-webuicontainer fails to recover after three successive restarts (e.g., due to a hardware freeze on the LoRa device itself), the watchdog will intelligently simulate a physical disconnection and reconnection of the device via a low-level USB bus reset, completely resolving hardware lockups.
Installation / Update
You can easily install or update the watchdog by running the provided installer script with root privileges:
cd ~/mc-webui/scripts/watchdog
sudo ./install.sh
Detailed Documentation
For full details on configuration, logs, troubleshooting, and more advanced features, please refer to the main Container Watchdog Documentation located in the docs folder.