Frequently Asked Questions

Hanergy is a Home Assistant add-on for solar surplus management. It automatically distributes excess solar energy across your devices — EV chargers, heat pumps, pool pumps, batteries — using a priority-cascade approach. The highest-priority load gets surplus first, then the next, and so on down the list.

EMHASS uses linear programming with cost functions, day-ahead forecasts, and a solver. It is powerful but has a steep configuration curve. Hanergy uses a priority cascade instead: "If there is surplus, charge the car first. If there is still surplus, heat the water." No cost functions, no forecasts, no solver — just a clear, inspectable priority list.

Yes. Hanergy is fully offline capable. All processing happens locally on your Home Assistant instance. An internet connection is only needed for initial license activation (Free and Pro tiers). After that, the add-on runs entirely on your local network.

Any device controllable through Home Assistant. This includes switch entities (on/off), number entities (adjustable setpoints), and input_number entities. Common examples: EV chargers, heat pumps, pool pumps, battery inverters, irrigation valves, and resistive heaters.

For HAOS or Supervised installations, add the repository URL in Settings → Add-ons → Add-on Store → Repositories, then install Hanergy from the store. For standalone Docker deployments, pull the image from ghcr.io/cusspvz/hanergy:latest and provide your HA URL and token as environment variables.

Hanergy requires Home Assistant with at least a solar production sensor and grid import/export sensors. It runs as a lightweight Go binary with minimal resource usage. Any system that can run Home Assistant can run Hanergy.

Yes. Hanergy provides multi-architecture Docker images including ARM (aarch64 and armv7). It runs efficiently on Raspberry Pi 3, 4, and 5 with Home Assistant OS.

Yes. Register a free account at cloud.hanergy.app to get started with the Free tier (account required): 2 devices, 2 priorities, and 2 months of updates. This is the entry point for all new users.

Nothing breaks. Hanergy continues to run with the last version covered by your license. All existing devices and priorities keep working. No features are removed. The only change is that newer releases are not available until you renew.

Licenses are bound to a specific installation ID. If you need to move your license to a new Home Assistant installation, contact support@hanergy.app for assistance.

Visit cloud.hanergy.app, purchase a Pro license (€60 one-time), and paste the new license token in your Hanergy Settings → License page. The upgrade takes effect immediately. Visit our installer program page for pricing details on installer accounts.

By default, every 10 seconds. This interval is configurable in the settings. The 10-second cycle provides a good balance between responsiveness and stability.

Yes. A battery inverter can be configured as a Dynamic load type. Hanergy adjusts the charge rate based on available surplus, just like it would for an EV charger or heat pump.

Yes. If you have multiple inverters, combine their output into a single Home Assistant template sensor and map that sensor in Hanergy settings. Alternatively, map individual sensors if your HA setup already provides a combined value.