Bitaxe - Exergy Home Assistant Integration

Monitor AND control your Bitaxe mining devices directly in Home Assistant. Full local control with no cloud dependency.

Before You Start

Before installing this integration:

Home Assistant 2024.1.0 or newer - This integration requires HA 2024.1.0+.
HACS installed - This is a custom integration distributed via HACS. See our system configuration guide if you need to set up HACS.
Bitaxe running ESP-Miner firmware - Your device must be running compatible ESP-Miner firmware.
Bitaxe IP address - The local IP where your Bitaxe is accessible.

What is Bitaxe?

Bitaxe is an open-source, ASIC-based bitcoin miner designed for home use. Key features:

Open hardware - Fully open-source hardware design
Compact - Small form factor for desktop/home use
Local-only - No cloud services required
Customizable - Adjustable frequency, voltage, and fan settings

Integration Features

The Exergy Bitaxe integration provides comprehensive monitoring AND control:

Sensors

Sensor	Entity Example	Description
Hashrate	`sensor.bitaxe_hashrate`	Current hashrate
Hashrate (1 min avg)	`sensor.bitaxe_hashrate_1m`	1-minute average hashrate
Hashrate (5 min avg)	`sensor.bitaxe_hashrate_5m`	5-minute average hashrate
Hashrate (1 hr avg)	`sensor.bitaxe_hashrate_1h`	1-hour average hashrate
Hashrate (24 hr avg)	`sensor.bitaxe_hashrate_24h`	24-hour average hashrate
Shares Accepted	`sensor.bitaxe_shares_accepted`	Total accepted shares
Shares Rejected	`sensor.bitaxe_shares_rejected`	Total rejected shares
Error Rate	`sensor.bitaxe_error_rate`	Share error rate percentage
Chip Temperature	`sensor.bitaxe_chip_temperature`	ASIC chip temperature
VR Temperature	`sensor.bitaxe_vr_temperature`	Voltage regulator temperature
Input Voltage	`sensor.bitaxe_input_voltage`	Input voltage
Core Voltage	`sensor.bitaxe_core_voltage`	ASIC core voltage (mV)
Power	`sensor.bitaxe_power`	Power consumption (W)
Fan Speed	`sensor.bitaxe_fan_speed`	Fan speed percentage
Uptime	`sensor.bitaxe_uptime`	Device uptime

Switches

Switch	Entity Example	Description
Auto Fan Speed	`switch.bitaxe_auto_fan`	Toggle automatic fan speed control
Overclock Enabled	`switch.bitaxe_overclock`	Toggle overclocking mode
Invert Screen	`switch.bitaxe_invert_screen`	Invert display colors

Number Controls

Control	Entity Example	Range	Description
Core Voltage	`number.bitaxe_core_voltage`	1000-1400 mV	ASIC core voltage
Frequency	`number.bitaxe_frequency`	100-1000 MHz	ASIC clock frequency
Fan Speed	`number.bitaxe_fan_speed`	0-100%	Manual fan speed (when auto off)
Temp Target	`number.bitaxe_temp_target`	30-100 C	Target temperature for auto fan
Display Timeout	`number.bitaxe_display_timeout`	-1 to 240 min	Screen timeout duration
Stats Frequency	`number.bitaxe_stats_frequency`	0-600 sec	Stats update frequency

Select Controls

Control	Entity Example	Options	Description
Screen Rotation	`select.bitaxe_screen_rotation`	0, 90, 180, 270	Display rotation angle

Buttons

Button	Entity Example	Description
Update Firmware	`button.bitaxe_update`	Trigger OTA firmware update
Restart	`button.bitaxe_restart`	Restart the device
Identify	`button.bitaxe_identify`	Flash screen/LED to identify device

Note: Entity IDs are generated based on your device name. Find actual IDs at Settings > Devices & Services > Bitaxe > [your device].

Installation

Step 1: Install via HACS

Open Home Assistant
Navigate to HACS > Integrations
Click + Explore & Download Repositories
Search for “Exergy Bitaxe”
Click Download
Restart Home Assistant

Step 2: Add Your Bitaxe

Go to Settings > Devices & Services
Click + Add Integration
Search for “Bitaxe”
Enter your configuration:

Setting	Default	Description
IP Address	—	Your Bitaxe’s local IP address
Port	80	HTTP port (usually 80)
Scan Interval	15 sec	How often to poll for updates (5-300 sec)

Click Submit

Step 3: Verify

The integration creates a device with all sensors and controls. Check the device page to see all available entities.

Finding Your Bitaxe IP Address

Method 1: Router Admin Panel

Log into your router’s admin interface
Look for “Connected Devices” or “DHCP Leases”
Find the device named “Bitaxe” or similar
Note the IP address

Method 2: Bitaxe Web Interface

If you’ve previously accessed your Bitaxe, check your browser history for the IP.

Method 3: Network Scanner

Use a network scanning app:

Fing (iOS/Android)
Advanced IP Scanner (Windows)
nmap (Linux/Mac)

Tip: Set a static IP or DHCP reservation for your Bitaxe to prevent the address from changing.

Dashboard Integration

Create a comprehensive Bitaxe control panel:

type: vertical-stack
cards:
  - type: entities
    title: Bitaxe Status
    entities:
      - entity: sensor.bitaxe_hashrate
        name: Hashrate
      - entity: sensor.bitaxe_chip_temperature
        name: Chip Temperature
      - entity: sensor.bitaxe_power
        name: Power
      - entity: sensor.bitaxe_shares_accepted
        name: Accepted Shares
      - entity: sensor.bitaxe_error_rate
        name: Error Rate

  - type: entities
    title: Bitaxe Controls
    entities:
      - entity: switch.bitaxe_auto_fan
        name: Auto Fan
      - entity: number.bitaxe_fan_speed
        name: Fan Speed
      - entity: number.bitaxe_frequency
        name: Frequency
      - entity: number.bitaxe_core_voltage
        name: Core Voltage

Automation Ideas

Temperature Protection

automation:
  - alias: "Bitaxe overheat protection"
    trigger:
      - platform: numeric_state
        entity_id: sensor.bitaxe_chip_temperature
        above: 75
    action:
      - service: number.set_value
        target:
          entity_id: number.bitaxe_frequency
        data:
          value: 400
      - service: notify.mobile_app
        data:
          message: "Bitaxe temperature high - reduced frequency"

Scheduled Performance Mode

automation:
  - alias: "Bitaxe night performance mode"
    trigger:
      - platform: time
        at: "23:00:00"
    action:
      - service: number.set_value
        target:
          entity_id: number.bitaxe_frequency
        data:
          value: 575

  - alias: "Bitaxe day efficiency mode"
    trigger:
      - platform: time
        at: "07:00:00"
    action:
      - service: number.set_value
        target:
          entity_id: number.bitaxe_frequency
        data:
          value: 450

Low Hashrate Alert

automation:
  - alias: "Bitaxe low hashrate alert"
    trigger:
      - platform: numeric_state
        entity_id: sensor.bitaxe_hashrate_1h
        below: 400
        for:
          minutes: 30
    action:
      - service: notify.mobile_app
        data:
          message: "Bitaxe hashrate dropped below 400 GH/s"