Public Pool - Exergy Home Assistant Integration

Monitor your self-hosted Public Pool instance directly in Home Assistant. Compatible with Start9 and other self-hosted deployments.

Before You Start

Before installing this integration:

Home Assistant with HACS installed - This is a custom integration distributed via HACS. See our system configuration guide if you need to set up Home Assistant and HACS.
Self-hosted Public Pool running - You need a Public Pool instance running (self-hosted or Start9).
Pool URL - The URL where your Public Pool instance is accessible.
Your Bitcoin address - The address you’re mining to (for address-level stats).

What is Public Pool?

Public Pool is open-source mining pool software designed for self-hosting. Key features:

Self-sovereign - Run your own pool infrastructure
Start9 compatible - Easy deployment on Start9 servers
Privacy-focused - Your data stays on your infrastructure
Solo mining - Mine blocks directly to your wallet
No fees - You control everything

Integration Features

The Exergy Public Pool integration provides multi-level monitoring:

Pool-Level Sensors

Sensor	Entity Example	Description
Pool Hashrate	`sensor.public_pool_hashrate`	Total pool hashrate in TH/s
Miner Count	`sensor.public_pool_miner_count`	Number of connected miners
Block Height	`sensor.public_pool_block_height`	Current block being worked on

Network-Level Sensors

Sensor	Entity Example	Description
Network Difficulty	`sensor.public_pool_network_difficulty`	Current bitcoin network difficulty
Network Hashrate	`sensor.public_pool_network_hashrate`	Network hashrate in EH/s
Blockchain Height	`sensor.public_pool_blockchain_height`	Current blockchain height

Address-Level Sensors

Sensors for your specific mining address:

Sensor	Entity Example	Description
Best Difficulty	`sensor.public_pool_address_best_difficulty`	Best difficulty share found
Worker Count	`sensor.public_pool_address_worker_count`	Number of workers for this address
Address Hashrate	`sensor.public_pool_address_hashrate`	Your address hashrate in GH/s

Per-Worker Sensors

For each worker detected, these sensors are created dynamically:

Sensor	Entity Example	Description
Worker Hashrate	`sensor.public_pool_worker_{name}_hashrate`	Worker hashrate in GH/s
Worker Best Difficulty	`sensor.public_pool_worker_{name}_best_difficulty`	Worker’s best difficulty share
Worker Last Activity	`sensor.public_pool_worker_{name}_last_activity`	Timestamp of last activity

Note: Entity IDs are automatically generated. Find your actual entity IDs at Settings > Devices & Services > Public Pool > [your device].

Installation

Step 1: Install via HACS

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

Step 2: Add Integration

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

Setting	Default	Description
Pool URL	—	URL to your Public Pool instance
Bitcoin Address	—	Your mining address for address-level stats
Scan Interval	60 sec	How often to poll for updates
SSL Verification	On	Toggle SSL certificate verification

Click Submit

Step 3: Verify

The integration creates sensors at pool, network, address, and worker levels. Check the device page to see all available entities.

Configuration

Pool URL Examples

Local Start9: http://public-pool.embassy:3334
Local network: http://192.168.1.100:3334
Remote with SSL: https://pool.example.com
Tor (Start9): Use local embassy address for better performance

Bitcoin Address

Enter the address your miners are configured to mine to. This enables:

Address-specific hashrate tracking
Best difficulty monitoring
Per-worker statistics

Scan Interval

Default is 60 seconds. Range: 30-300 seconds.

Lower intervals = more responsive but more API load
Higher intervals = less load but delayed updates

Start9 Integration

If running Public Pool on Start9:

Find your pool’s local address in Start9’s interface
Use the local embassy address: http://public-pool.embassy:3334
This avoids Tor latency for local access
For remote access, configure Tor proxy settings

Dashboard Integration

Display your Public Pool stats:

type: vertical-stack
cards:
  - type: entities
    title: My Public Pool
    entities:
      - entity: sensor.public_pool_hashrate
        name: Pool Hashrate
      - entity: sensor.public_pool_miner_count
        name: Connected Miners
      - entity: sensor.public_pool_address_hashrate
        name: My Hashrate
      - entity: sensor.public_pool_address_best_difficulty
        name: Best Difficulty

  - type: entities
    title: Network Stats
    entities:
      - entity: sensor.public_pool_network_difficulty
        name: Network Difficulty
      - entity: sensor.public_pool_network_hashrate
        name: Network Hashrate
      - entity: sensor.public_pool_blockchain_height
        name: Block Height

Automation Ideas

Worker Offline Alert

automation:
  - alias: "Public Pool worker offline"
    trigger:
      - platform: template
        value_template: >
          {{ (now() - states.sensor.public_pool_worker_miner1_last_activity.last_changed).total_seconds() > 600 }}
    action:
      - service: notify.mobile_app
        data:
          message: "Worker miner1 appears offline - no activity for 10 minutes"

New Best Difficulty Celebration

automation:
  - alias: "New best difficulty found"
    trigger:
      - platform: state
        entity_id: sensor.public_pool_address_best_difficulty
    condition:
      - condition: template
        value_template: "{{ trigger.to_state.state | float > trigger.from_state.state | float }}"
    action:
      - service: notify.mobile_app
        data:
          message: "New best difficulty: {{ states('sensor.public_pool_address_best_difficulty') }}!"

Low Hashrate Alert

automation:
  - alias: "Public Pool low hashrate"
    trigger:
      - platform: numeric_state
        entity_id: sensor.public_pool_address_hashrate
        below: 100
        for:
          minutes: 30
    action:
      - service: notify.mobile_app
        data:
          message: "Public Pool hashrate dropped below 100 GH/s"

Daily Mining Summary

automation:
  - alias: "Daily Public Pool summary"
    trigger:
      - platform: time
        at: "20:00:00"
    action:
      - service: notify.mobile_app
        data:
          message: >
            Public Pool Stats:
            Hashrate: {{ states('sensor.public_pool_address_hashrate') }} GH/s
            Best Diff: {{ states('sensor.public_pool_address_best_difficulty') }}
            Workers: {{ states('sensor.public_pool_address_worker_count') }}