Files
mc-webui/scripts/watchdog
MarekWo e98acf6afa feat(v2): Add pkt_payload to DMs, update watchdog for single container
- Add pkt_payload column to direct_messages table for stable packet
  hash generation and Analyzer URL linking
- Update insert_direct_message() and DeviceManager to store pkt_payload
- Add test for DM pkt_payload storage (43 tests pass)
- Update watchdog to monitor only mc-webui (meshcore-bridge removed)
- USB reset trigger now fires for mc-webui container failures

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-01 10:01:43 +01:00
..

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 meshcore-bridge container, which handles the physical connection to the LoRa device (like Heltec V3 or V4).

Key Capabilities

  • Automated Restarts: If a container becomes unhealthy or crashes, the watchdog automatically restarts it to restore service without human intervention.
  • Hardware USB Bus Reset: If the meshcore-bridge container 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.