Home Assistant has become the dominant smart home platform for technical users, and Bitcoin miners are no exception. The ability to monitor hashrate, control power output, automate schedules, and integrate mining with your home’s heating, solar, and electricity systems from a single dashboard is a compelling vision — and it is becoming reality.
This guide covers why miners want Home Assistant integration, what solutions exist today, what data you should monitor, the automation possibilities that make mining smarter, and where the future of mining IoT is heading.
Why Miners Want Home Assistant Integration
Bitcoin miners generate three things: hashrate, heat, and data. Home Assistant is built to manage exactly these kinds of inputs and outputs across your entire home. The appeal is straightforward:
- Unified dashboard: See your miner’s hashrate, temperature, and power draw alongside your home’s thermostat, solar production, and electricity usage — all in one place.
- Automation: Create rules like “if the house temperature drops below 20 degrees C, increase mining power” or “if electricity price exceeds $0.15/kWh, shut down the miner.”
- Alerting: Get push notifications on your phone if hashrate drops, temperature spikes, or a fan fails — through Home Assistant’s existing notification infrastructure.
- Historical data: Home Assistant’s built-in recorder stores months of data, giving you long-term trends for hashrate, power consumption, efficiency, and earnings.
- Family visibility: Non-technical household members can see a simple card showing “Miner: ON, Earning $X/day, Room temp: 22C” on the shared Home Assistant dashboard.
Current Solutions: What Exists Today
hass-miner Integration
The primary Home Assistant integration for Bitcoin miners is hass-miner, a community-built custom component available on GitHub. It uses the pyasic library to communicate with miners via the CGMiner API (port 4028) and exposes miner data as Home Assistant entities.
What hass-miner provides:
- Hashrate sensor (total and per-board)
- Temperature sensors (chip and board temperatures)
- Power consumption sensor
- Fan speed sensors
- Pool information
- Efficiency calculation (J/TH)
- Accepted/rejected share counts
What hass-miner currently lacks:
- Reliable reboot/restart service: The reboot command does not work consistently across all firmware types.
- Power control: You cannot change the miner’s power target or switch profiles from Home Assistant.
- Per-chip data: Only summary statistics are exposed, not individual chip health.
- Real-time updates: The integration polls at intervals (typically 30-60 seconds) rather than receiving real-time data streams.
- Per-hashboard control: You cannot enable/disable individual hash boards from the HA interface.
Braiins-OS-HA Integration
A separate community project (Braiins-OS-HA on GitHub) provides BraiinsOS-specific integration using the Braiins gRPC API. It offers deeper access to BraiinsOS features but is limited to that single firmware.
Custom API Approaches
Some miners build their own integrations using Home Assistant’s REST or command-line sensor platforms, calling the miner’s API directly. This works but requires significant configuration and lacks the polish of a dedicated integration.
What Data Should You Monitor?
A well-configured mining dashboard in Home Assistant should track these key metrics:
Performance Metrics
| Metric | What It Tells You | Alert Threshold |
|---|---|---|
| Hashrate (TH/s) | Current mining performance | Alert if drops below 80% of expected |
| Hashrate per board | Individual board health | Alert if any board drops below 70% |
| Accepted shares | Pool is receiving your work | Alert if zero for 5+ minutes |
| Rejected share rate | Work quality / stale shares | Alert if exceeds 2% |
| Efficiency (J/TH) | Power efficiency of mining | Monitor for degradation over time |
Thermal Metrics
| Metric | What It Tells You | Alert Threshold |
|---|---|---|
| Chip temperature | ASIC die temperature | Alert above 85C, critical above 95C |
| Board temperature | PCB temperature | Alert above 80C |
| Fan speed (RPM) | Cooling system status | Alert if any fan below 1000 RPM |
| Intake air temp | Ambient/room temperature | Alert above 35C (external sensor) |
| Exhaust air temp | Heat output measurement | Used for heating calculations |
Power and Economic Metrics
| Metric | What It Tells You | Alert Threshold |
|---|---|---|
| Power draw (watts) | Current electricity consumption | Alert if exceeds circuit capacity |
| Daily kWh | Energy consumption for costing | Track for billing accuracy |
| Electricity cost ($/day) | Operating cost | Alert if exceeds revenue |
| Estimated revenue ($/day) | Mining income estimate | Monitor for profitability |
| Profit/loss ($/day) | Net economic result | Alert if negative for 24+ hours |
Automation Possibilities
This is where Home Assistant integration becomes genuinely powerful. Here are automation scenarios that miners are building today or that become possible with firmware-level MQTT support:
Thermostat-Controlled Mining
Use your miner as an intelligent space heater:
- Trigger: Room temperature (from a separate HA temperature sensor) drops below your setpoint (e.g., 21 degrees C).
- Action: Increase miner power target to maximum, directing hot exhaust air into the room.
- When satisfied: Room reaches setpoint, miner throttles back to eco mode or shuts down.
This effectively turns your ASIC miner into a thermostat-controlled heater that earns Bitcoin while warming your home. The economics are compelling: you need heat anyway, and the miner provides it while generating revenue that offsets (or exceeds) the electricity cost.
Solar-Aware Mining
- Trigger: Home Assistant monitors your solar inverter (Enphase, SolarEdge, or similar) and detects surplus production exceeding household consumption.
- Action: Set miner power target to match the surplus (e.g., if you have 2kW surplus, set miner to 2,000W).
- When clouds roll in: Solar production drops, miner automatically reduces power to avoid drawing from the grid.
This ensures you mine exclusively with free solar electricity, maximizing profitability.
Electricity Price Response
- Trigger: Home Assistant pulls real-time electricity rates from your utility’s API (or a service like Amber Electric, Octopus Energy, or ERCOT price feeds).
- Action: If the current rate exceeds your break-even threshold, send a curtailment command to the miner. If rates go negative (common in renewable-heavy grids), ramp to maximum power.
Safety Automations
- Temperature guard: If the room where the miner is located exceeds 40 degrees C (measured by a separate sensor), immediately shut down the miner. This protects against ventilation failures in enclosed setups.
- Smoke detector integration: If a connected smoke detector triggers, immediately shut down the miner and send a priority notification.
- Water leak detection: For immersion setups, a water/fluid leak sensor near the tank triggers an emergency shutdown.
- Power monitoring: If a smart plug or energy monitor detects the miner drawing more than the circuit’s rated capacity, trigger a power reduction.
Lifestyle Automations
- “Goodnight” scene: When you trigger your bedtime routine in Home Assistant, the miner automatically switches to Night Mode (reduced power, minimum fan speed).
- “Away from home” scene: When everyone leaves (detected via phone presence), miner ramps to full power since noise does not matter.
- “Movie time” scene: Miner drops to minimum power or sleep mode for maximum quiet.
- “Working from home” automation: During video call hours, miner reduces to quiet mode based on your calendar.
The MQTT Advantage
The most robust way to integrate a mining device with Home Assistant is through MQTT (Message Queuing Telemetry Transport) — a lightweight messaging protocol designed for IoT devices.
Why MQTT Is Better Than API Polling
- Real-time updates: The miner publishes data the instant it changes, rather than waiting for Home Assistant to poll. Hashrate drops, temperature spikes, and fan failures are reported immediately.
- Lower overhead: MQTT messages are tiny (bytes, not kilobytes), minimizing network and CPU impact on both the miner and the HA server.
- Bidirectional control: Home Assistant can publish commands to MQTT topics that the miner subscribes to, enabling real-time control (power target changes, profile switches, reboot commands).
- Auto-discovery: MQTT supports Home Assistant’s auto-discovery protocol. When a new DCENT_OS miner appears on your network, it can automatically register itself as a device in Home Assistant — no manual configuration needed.
What DCENT_OS Publishes via MQTT
D-Central’s DCENT_OS is being designed with a native MQTT broker that publishes every miner metric as a structured MQTT topic:
dcent/{miner_id}/hashrate— Total hashrate in TH/sdcent/{miner_id}/board/{n}/hashrate— Per-board hashratedcent/{miner_id}/temperature/chip— Chip temperaturedcent/{miner_id}/temperature/board/{n}— Per-board temperaturedcent/{miner_id}/power/watts— Current power drawdcent/{miner_id}/fan/{n}/rpm— Per-fan RPMdcent/{miner_id}/efficiency— Current J/THdcent/{miner_id}/pool/status— Pool connection statusdcent/{miner_id}/status— Overall miner status (mining, idle, error)
Control topics allow Home Assistant to command the miner:
dcent/{miner_id}/command/power_target— Set power target in wattsdcent/{miner_id}/command/profile— Switch power profile (eco, balanced, performance, sleep)dcent/{miner_id}/command/reboot— Trigger a rebootdcent/{miner_id}/command/night_mode— Enable/disable night mode
Setting Up a Mining Dashboard in Home Assistant
Here is what a well-designed mining dashboard looks like in Home Assistant:
Overview Card
A summary card showing the most important at-a-glance information:
- Miner status (online/offline indicator)
- Current hashrate with sparkline trend
- Current power draw
- Today’s estimated earnings
- Active power profile (eco/balanced/performance)
Performance Charts
Historical graphs powered by Home Assistant’s recorder:
- 24-hour hashrate chart (spot drops and instability)
- 7-day power consumption (correlate with electricity bill)
- Temperature trends (identify cooling issues before they become failures)
- Efficiency trend over weeks/months (track chip degradation)
Control Panel
Interactive controls for daily management:
- Power profile selector (dropdown or buttons for eco/balanced/performance/sleep)
- Power target slider (set exact wattage)
- Night mode toggle
- Reboot button (with confirmation)
Economic Summary
Financial tracking:
- Daily/weekly/monthly BTC mined
- Daily/weekly/monthly electricity cost
- Net profit/loss
- Heating cost offset (if using as space heater)
ESPHome Companion Sensors
For the most comprehensive setup, pair your miner with ESPHome-based environmental sensors. These inexpensive ESP32 devices can measure:
- Room temperature and humidity: Feed into thermostat-controlled mining automation.
- Exhaust air temperature: Calculate actual heat output in BTU/hour.
- Sound level (dB): Verify that your noise reduction measures are achieving target levels.
- Air quality (CO2/particulates): Important for enclosed mining setups.
DCENT_OS documentation will include ESPHome YAML configurations for recommended companion sensors, making the setup straightforward even for users new to ESPHome.
The Future of Mining IoT
The integration of Bitcoin mining into smart home ecosystems is still in its early stages. Here is where things are heading:
Mining as a Grid Resource
As electricity grids become more dynamic (with real-time pricing, demand response programs, and renewable intermittency), miners that can respond instantly to grid signals become valuable grid resources. Home Assistant, connected to grid price feeds and utility APIs, becomes the orchestration layer that tells your miner when to ramp up and when to curtail — earning you both Bitcoin and demand response payments.
Mining as Home Infrastructure
The concept of a “Bitcoin heater” — an appliance that heats your home while earning cryptocurrency — is evolving from DIY project to consumer product. Products like the Superheat H1 Bitcoin mining water heater (announced at CES 2026) show the direction. Firmware with native smart home integration is essential for these products to function as true home appliances rather than noisy computers.
Voice Control
Through Home Assistant’s bridge to Alexa and Google Home, voice control of your miner becomes possible: “Hey Google, set the miner to quiet mode.” This is not a gimmick — it is the kind of integration that makes mining acceptable to every member of the household.
Multi-Miner Coordination
For home miners running 2-10 units, Home Assistant can coordinate across all miners: balancing total power draw against circuit capacity, distributing heat to different rooms based on temperature sensors, and ensuring that total noise stays within acceptable levels during quiet hours.
Getting Started
If you already have Home Assistant running, here is the simplest path to monitoring your miners:
- Install hass-miner from HACS (Home Assistant Community Store). This gets you basic monitoring with any firmware that supports the CGMiner API.
- Create a dashboard with hashrate, temperature, and power sensors. Start with the basics before building complex automations.
- Add one automation — a notification when hashrate drops below a threshold is the most universally useful starting point.
- Expand from there — add temperature-based control, TOU scheduling, or solar integration as your comfort level grows.
For the full experience — real-time MQTT data, bidirectional control, auto-discovery, and native Home Assistant entity support — watch for DCENT_OS, which is being built from the ground up with Home Assistant as a first-class integration partner rather than an afterthought.
Frequently Asked Questions
Yes, with limitations depending on your firmware. The hass-miner integration (available via HACS) provides monitoring capabilities for any miner supporting the CGMiner API, including hashrate, temperature, power, and fan speed data. Control capabilities (changing power targets, switching profiles, rebooting) are limited with current integrations. DCENT_OS is being developed with native MQTT support that will enable full bidirectional control from Home Assistant, including power target adjustment, profile switching, night mode, and reboot commands.
MQTT (Message Queuing Telemetry Transport) is a lightweight messaging protocol designed for IoT devices. For Bitcoin mining, MQTT enables real-time data streaming from your miner to Home Assistant (or any IoT platform) with minimal overhead. Unlike API polling, which checks the miner every 30-60 seconds, MQTT publishes updates instantly when values change. It also supports bidirectional communication, meaning Home Assistant can send control commands back to the miner. MQTT’s auto-discovery feature allows new miners to automatically register themselves in Home Assistant without manual configuration.
Yes, this is one of the most compelling Home Assistant mining automations. By combining a temperature sensor in the room with control over the miner’s power output, you can create an automation that increases mining power when the room is cold and reduces it when the temperature setpoint is reached. The miner effectively becomes a space heater that earns Bitcoin. This requires firmware that accepts power target commands from Home Assistant (via API or MQTT). D-Central’s Bitcoin space heater enclosures combined with DCENT_OS firmware are designed specifically for this thermostat-controlled mining use case.
The easiest method is installing the hass-miner integration from HACS (Home Assistant Community Store). Once configured with your miner’s IP address, it creates sensor entities for hashrate, temperature, power consumption, fan speed, and more. These sensors can be displayed on dashboards, used in automations, and recorded for historical analysis. For BraiinsOS users, the Braiins-OS-HA integration provides additional firmware-specific data. For the most comprehensive monitoring, DCENT_OS will offer native MQTT auto-discovery, creating all entities automatically when a new miner appears on your network.
