33 lines
1.5 KiB
Markdown
33 lines
1.5 KiB
Markdown
# Home Assistant add-on: networking, VLANs, and multiple interfaces
|
|
|
|
This directory contains the full set of materials related to running GREE Controller as a Home Assistant add-on:
|
|
|
|
- multi-arch build (`build.sh`)
|
|
- Dockerfile targets for `trixie` and `alpine`
|
|
- add-on repository (`https://git.linuxiarz.pl/gru/gree-controller-ha-addon/`)
|
|
- networking documentation (`https://git.linuxiarz.pl/gru/gree-controller-ha-addon/gree-controller/DOCS.md`, `https://git.linuxiarz.pl/gru/gree-controller-ha-addon/gree-controller/DOCS.pl.md`)
|
|
- topology diagrams (`docs/topology-ha-vlan-gree-en.png`, `docs/topologia-ha-vlan-gree-pl.png`)
|
|
|
|
## Quick conclusion
|
|
|
|
For a Home Assistant add-on, the recommended model is:
|
|
|
|
- `host_network: true`
|
|
- configure VLANs and interfaces on the HA OS host
|
|
- the add-on reuses the host interfaces
|
|
- do not use `macvlan` inside the add-on
|
|
|
|
## Where the diagrams are
|
|
|
|
- `docs/topology-ha-vlan-gree-en.png` - English version
|
|
- `docs/topologia-ha-vlan-gree-pl.png` - Polish version
|
|
- `https://git.linuxiarz.pl/gru/gree-controller-ha-addon/gree-controller/topology-ha-vlan-gree-en.png` - repository copy EN
|
|
- `https://git.linuxiarz.pl/gru/gree-controller-ha-addon/gree-controller/topologia-ha-vlan-gree-pl.png` - repository copy PL
|
|
|
|
## Where the docs are
|
|
|
|
- `docs/README.en.md`
|
|
- `docs/README.pl.md`
|
|
- `https://git.linuxiarz.pl/gru/gree-controller-ha-addon/gree-controller/DOCS.md`
|
|
- `https://git.linuxiarz.pl/gru/gree-controller-ha-addon/gree-controller/DOCS.pl.md`
|