gree-controller-ha-addon/gree-controller/README.md

GREE Controller

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

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 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/