miner-sentinel
MinerSentinel es un panel de monitorización self-hosted para flotas de minería Bitcoin doméstica, compatible con dispositivos ASIC Bitaxe y Avalon. Normaliza APIs heterogéneas en una base de datos PostgreSQL única, ofreciendo dashboards unificados, análisis de eficiencia energética, seguimiento de p
Ficha actualizada 27 sept 2026, 12:07 · upstream 27 sept 2026, 12:01 · release 1.0.3
Qué es miner-sentinel
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
MinerSentinel actúa como stack de monitorización autoalojado que unifica el control de equipos de diferentes fabricantes bajo un único registro y tablas de series temporales compartidas. La arquitectura consta de cuatro servicios Docker: Frontend en React 18 con Vite, Backend en Django REST Framework para la API y autenticación, Data Service en Flask para la recolección de métricas y PostgreSQL como base de datos persistente. Permite visualizar hashrate, temperatura, consumo eléctrico y estado del hardware en tiempo real, además de calcular probabilidades de minería solitaria y costes estimados basados en tarifas energéticas configurables.
El sistema soporta integración directa con Umbrel mediante un paquete oficial, facilitando la instalación en entornos domésticos sin necesidad de Docker Compose manual. La gestión de dispositivos se realiza a través de una interfaz web intuitiva donde se añaden direcciones IP y puertos específicos (como el TCP 4028 para Avalon), mientras que las alertas críticas sobre desconexiones o estancamiento del hashrate se envían automáticamente a canales de mensajería configurados.
- Monitorización centralizada de flotas mixtas de ASICs (Bitaxe, Avalon, NMAxe).
- Análisis de eficiencia energética y costes operativos por dispositivo.
- Recepción de alertas en tiempo real sobre fallos o desconexiones de minería.
- Gestión de estadísticas de pools de minería (CKPool, Public Pool) desde una única vista.
- Visualización histórica de tendencias de rendimiento y salud del hardware.
- Normalización de datos de múltiples fabricantes en un único esquema de base de datos.
- Compatibilidad nativa con la plataforma Umbrel para despliegue simplificado.
- Sistema de alertas configurable vía Telegram o Discord webhooks.
- Cálculo automático de métricas de eficiencia (J/TH) y costes energéticos.
- Arquitectura modular con separación clara entre recolección de datos y frontend.
- Requiere acceso de red local (LAN) a los dispositivos ASIC para la recolección de métricas.
- No incluye Dockerfile nativo, dependiendo de imágenes pre-construidas o Docker Compose.
- Configuración de seguridad en producción exige variables de entorno específicas (SECRET_KEY).
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Utilizar docker compose up -d para despliegue local o instalar desde Umbrel. Configurar .env con credenciales PostgreSQL y claves secretas antes de iniciar servicios. Asegurar acceso LAN a los dispositivos ASIC y configurar alertas en la interfaz web tras el arranque inicial.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.