Local GREE HVAC controller packaged as a Home Assistant add-on, with Web UI, HTTP/WebSocket API, built-in Swagger API documentation, UDP discovery/control, amd64 and aarch64 support, ingress, and database backup from /data/gree-controller.db.

Version 0.15.19 fixes Flow thermostat OFF semantics: zone_thermostat power=false powers the assigned unit off without disabling the Zone, so Flow and thermostat evaluation remain active.

For VLAN deployments, configure VLAN interfaces on the Home Assistant OS host. The add-on uses host_network: true; with multiple directly attached subnets, gree_interface may remain empty. Run broadcast discovery separately for each VLAN/subnet.

Full documentation: DOCS.md.

The controller exposes /api/* and /ws. Interactive API documentation is available at /api-docs, with the OpenAPI 3.1 document at /api-docs/openapi.json. The same paths work through Home Assistant ingress; direct access on port 8787 follows the configured app_token rules.

The same Git repository also contains the optional custom_components/gree_controller integration. It is distributed with the repository but is not installed automatically with the add-on.

Repository: https://git.linuxiarz.pl/gru/gree-controller-ha-addon/