MiningOS provides a comprehensive alerting system to monitor mining operations and notify operators of issues requiring attention. This manual covers alert severity levels, locations within the UI, and container-specific visual indicators.
For operational guidelines on maintaining alert visibility, see Operational Best Practices. For how alerts are generated and processed through the system, see Architecture Guide.
Alert Severity Levels
MiningOS classifies alerts into three severity levels, each with distinct visual indicators and response expectations.
Requires immediate attention; triggers audio notification
Lower severity than critical; requires prompt investigation
Least severe; informational or minor issues
Audio Notifications
Critical alerts trigger a buzzer sound on the Alerts Overview page. The buzzer behavior is controlled through the bell icon:
Buzzer sounds when critical alert triggers
Silenced until new alarms trigger or user unmutes
Alert Locations
Alerts appear in multiple locations throughout MiningOS to ensure visibility regardless of which page the operator is viewing.
The Header displays total alert counts by severity. Clicking any severity icon navigates directly to the filtered Alerts Overview page.
Click to view critical alerts
Click to view high alerts
Click to view medium alerts
For complete header documentation, see Header.
Dashboard Active Incidents
The Dashboard displays recent alerts in the Active Incidents card. Clicking any alert navigates to that specific alert in the Alerts Overview page.
For dashboard details, see Dashboard.
Alerts Overview Page
The primary alert management interface. Critical alerts trigger audio notifications only when this page is open in an active browser tab.
Recommendation: Keep this page open in a dedicated browser tab at all times. See Operational Best Practices.
Filtering Alerts
The filtering tool supports multiple criteria:
Miner, Container, Power meter, Sensor
Mining, Offline, Error, Sleep
wrong_miner_pool, all_pools_dead
The table displays all site alerts with navigation to the affected device.
System identifier (e.g., wrong_miner_pool)
Human-readable explanation
Priority level with color indicator
When the alert was triggered
Explorer Alerts
The Explorer displays alerts for selected devices.
Error icons appear in the Explorer list for miners in error state. Hover to view error details.
Select a single miner to view its active alerts in the details panel.
For miner selection and filtering, see Explorer.
Container Alerts
Hover over the alert icon in the Explorer list to view active container alerts. The Alerts card shows both container alerts and alerts from miners within that container.
Widgets Page Alerts
The Widgets Page displays alert icons on container widgets. Container names flash red when alarms are active.
Hover over alert icons to view descriptions.
Container Detail Alerts
Container detail pages display alerts in the Alarms and Events section.
For container-specific interfaces, see:
Alert Reference
For a complete list of all MiningOS alerts organized by device type, refer to the Classes of Alerts by Thing reference document.
Common Alert Codes
Alert Code
Description
Severity
All mining pool connections failed
Miner connected to incorrect pool
Miner using wrong subaccount
Worker name doesn't match MiningOS ID
Worker name contains IP instead of ID
For pool configuration and monitoring, see Pool Manager Module. For pool worker setup, see Installation Guide.
Visual Alerts by Container Type
Each container type has specific temperature and pressure thresholds that trigger visual alerts. Thresholds are calibrated for the container's cooling system. For container specifications, see Supported Devices — Containers.
Color Progression
All container types follow a consistent color progression for temperature and pressure alerts:
Suboptimal but acceptable
Warning—approaching limits
Critical—immediate attention required
Critical with audio alert
Bitdeer Containers
Documentation: Container Example: Bitdeer
Specifications: Supported Devices — Bitdeer Containers
Oil Temperature (L)
Temperature thresholds configured for optimal cooling system operation. Visual indicators progress from GREEN (optimal) through YELLOW/ORANGE (warning) to RED (critical) with flashing and sound alerts at critical thresholds.
Pressure thresholds indicate coolant system health:
Potential leaks or insufficient coolant
Potential blockages or system faults
Immersion Containers
Monitors Pri. Liquid supply Temp, Sec. Liquid supply Temp1, Sec. Liquid supply Temp2, and Sec. Supply Liquid Set Temp.
Oil Temperature (Sec. Supply 1 & 2)
Temperature monitoring follows similar patterns to Bitdeer containers, calibrated for immersion cooling systems. Visual indicators progress from RED (too cold) through YELLOW (suboptimal) to GREEN (optimal) and back through ORANGE to RED (overheating).
Note: Widget flashes red for circulating_pump_fault alerts.
MicroBT Containers
Specifications: Supported Devices — MicroBT Containers
Water Temperature (Unit Inlet Temp T2)
Water cooling thresholds calibrated for water-based heat exchange. Visual indicators follow standard progression with flashing and sound alerts at critical levels.
Bitmain Hydro Containers
Documentation: Container Example: Antspace Hydro
Specifications: Supported Devices — Bitmain Antspace
Water Temperature
Monitors Supply Liquid Temp and Supply Liquid Set Temp. Thresholds specific to Bitmain Hydro cooling architecture with enhanced visual and audio notifications at critical levels.
Supply Liquid Pressure
Pressure monitoring uses standard threshold logic:
Critical low or high pressure
Operator Manual
Header — Alert counts and quick navigation
Comments — Adding notes to devices with alerts
Architecture & Technical Reference
