Add Home Assistant chart
Co-Authored-By: Claude Opus 5.5 <[email protected]>
This commit is contained in:
@@ -0,0 +1,47 @@
|
||||
# homeassistant-gitops
|
||||
|
||||
Helm chart for [Home Assistant](https://www.home-assistant.io/) (container install) on the
|
||||
single-node cluster (`loki`), deployed by ArgoCD via the `apps-in-apps` repo into the
|
||||
namespace `homeassistant`.
|
||||
|
||||
URL: https://homeassistant.smokyzone.de:30444 (LAN / Tailscale only; the DNS record
|
||||
points at the node's private IP `192.168.2.218`). Certificate from
|
||||
`letsencrypt-dns-cloudflare` (DNS-01).
|
||||
|
||||
## Design
|
||||
|
||||
- **hostNetwork**: HA runs in the node's network namespace so LAN discovery (mDNS/SSDP:
|
||||
Chromecast, Hue, Sonos, HomeKit, ...) works. Side effect: plain HTTP is also served on
|
||||
`http://192.168.2.218:8123` in the LAN. Set `hostNetwork: false` if you don't need
|
||||
discovery.
|
||||
- **Config** lives on the `local-path` PVC `homeassistant-config` (`/config`), which is kept
|
||||
when the app is deleted. Back it up (users, integrations, history are in there).
|
||||
- **configuration.yaml** is seeded once by an init container (see `seedConfiguration` in
|
||||
`values.yaml`), including the reverse-proxy block:
|
||||
|
||||
```yaml
|
||||
http:
|
||||
use_x_forwarded_for: true
|
||||
trusted_proxies: [10.1.0.0/16, 127.0.0.1]
|
||||
```
|
||||
|
||||
Without it HA answers `400 Bad Request` through the ingress. After the first start the
|
||||
file is yours; the chart never overwrites it. Edit it with
|
||||
`kubectl -n homeassistant exec -it deploy/homeassistant -- vi /config/configuration.yaml`
|
||||
and restart the pod (or *Developer tools → YAML → Restart* in the UI).
|
||||
- **USB radios** (Zigbee/Z-Wave): list the device under `devices:` (prefer
|
||||
`/dev/serial/by-id/...`) and set `privileged: true`.
|
||||
- This is the container install: there is no add-on store (Supervisor). Add-ons such as
|
||||
Mosquitto or Zigbee2MQTT would run as their own deployments in the cluster.
|
||||
|
||||
## First start
|
||||
|
||||
1. Open https://homeassistant.smokyzone.de:30444 and create the owner account during
|
||||
onboarding (first visitor becomes the owner, so do this right away).
|
||||
2. Home location / units / language (Deutsch) in the onboarding wizard.
|
||||
3. Companion app: server URL `https://homeassistant.smokyzone.de:30444` (works at home and
|
||||
via Tailscale).
|
||||
|
||||
## Upgrades
|
||||
|
||||
Bump `image.tag` in `values.yaml` (see the release notes for breaking changes first).
|
||||
Reference in New Issue
Block a user