Skip to content

Getting Started

Everything you need to install Hanergy and get your first solar surplus automation running in minutes.

Installation Methods

Hanergy supports two deployment methods:

The primary installation method for users running Home Assistant OS or Home Assistant Supervised. The add-on integrates directly with the Supervisor and appears in the HA sidebar.

Installation Guide

For users running Home Assistant Core in Docker, or those who want Hanergy on a separate machine. Connects to HA via the REST API using a long-lived access token.

Docker Guide

Prerequisites

Before installing, confirm the following:

  • Home Assistant 2024.1 or later — Hanergy requires recent HA APIs for entity state subscriptions.
  • At least one solar production sensor — a numeric sensor reporting watts (W) or kilowatts (kW), typically from your solar inverter.
  • Grid import and grid export sensors — most smart meters and energy inverters expose these as separate entities. Hanergy needs both to calculate surplus.
  • At least one controllable device — any Home Assistant entity of domain switch (for fixed loads) or number / input_number (for dynamic loads with adjustable setpoints).

Consumption sensor is optional

If you do not have a dedicated consumption sensor, Hanergy derives total consumption automatically using the formula: production + grid_import - grid_export.

What to Do Next

  1. Install Hanergy — follow the step-by-step add-on or Docker installation.
  2. Complete the Setup Wizard — map your energy sensors, add your first device, and create a priority entry.
  3. Configure Your System — fine-tune devices, priorities, and engine settings.