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.10 expands Visual Flow keyboard authoring and portability with keyboard-first block creation/editing, a built-in shortcut reference and direct Flow export from the Flow list.
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/