Hi everyone,
I am Lenti, and
I have been building MinerWatch: a local-first, free and open-source dashboard for monitoring home Bitcoin mining setups.The goal is simple: keep miner monitoring private, local and practical.
MinerWatch runs on your own machine or server, polls miners directly on your LAN, and does not require a cloud account, external service, telemetry endpoint or hosted dashboard.
Main repository:https://github.com/imlenti/MinerWatchUmbrel Community App Store:https://github.com/imlenti/minerwatch-app-storeESP32 / ESPHome MQTT display project:https://github.com/imlenti/MinerWatch-MQTT-with-ESPHome
What MinerWatch doesMinerWatch is designed for people running small or home mining fleets who want a clean local view of what is happening across their miners.
It can show:
- miner online/offline status
- fleet hashrate
- per-miner hashrate
- power usage
- efficiency
- chip and VR temperatures
- fan speed and uptime
- pool/share information where available
- best shares and historical records
- simple analytics and mining odds
- live share stream for supported setups
The project is still young and moving quickly, so I am especially interested in compatibility reports, edge cases, miner API differences and installation feedback.
ScreenshotsDashboard overviewhttps://github.com/imlenti/MinerWatch/blob/main/docs/screenshots/dashboard.pngAnalytics / records viewhttps://github.com/imlenti/MinerWatch/blob/main/docs/screenshots/analytics.pngLive shares / mining data viewhttps://github.com/imlenti/MinerWatch/blob/main/docs/screenshots/liveshares.png
Supported / target setupsMinerWatch is currently focused on home and small-fleet Bitcoin miners, including setups around:
- Bitaxe-style miners
- NerdQaxe / NerdOctaxe-style miners
- Avalon Nano-style miners
- Braiins / BMM-style setups
- other local miner APIs where support can be added cleanly
If you run a miner that is not currently supported, I would still be interested in hearing from you. API samples, screenshots, device model, firmware version and local endpoint behavior are very useful for adding support.
Install optionsMinerWatch can be used in several ways depending on your setup:
- macOS / Linux / Windows WSL - run it directly from the main repository
- Docker - useful for always-on local servers
- Umbrel - one-click style install through the community app store
- ESP32 display - optional ESPHome firmware that reads the MinerWatch MQTT feed
Main install instructions live in the README:
https://github.com/imlenti/MinerWatch#readmeUmbrel Community App Store:
https://github.com/imlenti/minerwatch-app-storeESPHome / ESP32 MQTT panel:
https://github.com/imlenti/MinerWatch-MQTT-with-ESPHome
Umbrel supportThere is a separate Umbrel Community App Store repository for MinerWatch.
Umbrel users can add the community store URL and install MinerWatch from there:
https://github.com/imlenti/minerwatch-app-storeThe Umbrel package uses Docker and keeps the app data in the Umbrel app data directory, so updates should preserve local MinerWatch data.
https://i.redd.it/hx2p7pej9x3h1.png
ESP32 / ESPHome MQTT displayI also created a companion ESPHome project for ESP32 touch panels.
The idea is to let MinerWatch publish mining data over MQTT, then display that data on a small physical panel near the miners.
ESP32 project:
https://github.com/imlenti/MinerWatch-MQTT-with-ESPHomeIt currently targets Guition/CYD-style ESP32 panels and is meant to show a live local mining dashboard without configuring every miner manually on the panel.
https://github.com/imlenti/MinerWatch-MQTT-with-ESPHome/blob/main/mqtt-esp32.jpg
Privacy / local-first approachMinerWatch is intentionally local-first:
- no cloud account required
- no external hosted dashboard required
- no telemetry endpoint
- miner data is read from your LAN
- you can run it yourself, inspect it, fork it or package it differently
The project is licensed under AGPL-3.0:
https://github.com/imlenti/MinerWatch/blob/main/LICENSE
Development statusMinerWatch is early, but active.
The repository was created in May 2026 and is being developed quickly. Releases are tagged on GitHub:
https://github.com/imlenti/MinerWatch/releasesIf you try it, the most useful feedback would be:
- miner model and firmware version
- install method used: direct, Docker, Umbrel, etc.
- whether discovery/API polling works correctly
- which metrics are missing or inaccurate
- screenshots of errors or logs if something breaks
- feature requests from real mining setups
GitHub issues:
https://github.com/imlenti/MinerWatch/issues
Links
Thanks for reading.
I am not trying to sell anything here. MinerWatch is free and open-source and I am sharing it because I think local monitoring tools for home miners are useful.
If anyone here runs Bitaxe, NerdQaxe, Avalon Nano, Braiins, LuxOS or similar miners and wants to test it, feedback would be very welcome.
