1.4 KiB
GREE Controller
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.18 records the exact Flow condition trace at execution time and shows the evaluated Flow variables and gates directly under Recently triggered automations in Control plan.
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/