mirror of
https://github.com/MarekWo/mc-webui.git
synced 2026-07-04 08:51:58 +02:00
MarekWo
2f82c589c7
Implement a smart auto-detection and low-level fcntl ioctl reset mechanism for LoRa USB devices. This 'last resort' recovery is triggered if the meshcore-bridge container fails to recover after 3 restarts within an 8-minute window. Includes updates to the installer, systemd service, and newly added README. Co-Authored-By: Gemini CLI <noreply@google.com>
22 lines
1.3 KiB
Markdown
22 lines
1.3 KiB
Markdown
# 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:
|
|
|
|
```bash
|
|
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](../../docs/watchdog.md) located in the `docs` folder.
|