59bfd8bf695f6b0aba30906c51f640b3e8ee692c
Co-Authored-By: Claude Opus 5.5 <[email protected]>
homeassistant-gitops
Helm chart for Home Assistant (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 - public, like git: the DNS record is a
Cloudflare-proxied CNAME to git.smokyzone.de (public IP kept current by the ddns
CronJob), the router forwards 443 to the ingress. The companion app works without VPN.
Protection is HA itself: every user needs MFA (TOTP), and the HTTP settings ban an IP after
5 failed logins (ingress-nginx passes the real client IP from Cloudflare's
CF-Connecting-IP). 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:8123in the LAN. SethostNetwork: falseif you don't need discovery. - Config lives on the
local-pathPVChomeassistant-config(/config), which is kept when the app is deleted. Back it up (users, integrations, history are in there). - Reverse proxy: since 2026.10 HA keeps its HTTP settings in
/config/.storage/http(managed in the UI under Settings → System → Network). Anhttp:block inconfiguration.yamlis only imported once as an unconfirmed trial and silently reverted after 5 minutes (then HA answers400 Bad Requestthrough the ingress). The init container therefore seeds that store on first start withuse_x_forwarded_for: trueandtrustedProxiesfromvalues.yaml(pod network10.1.0.0/16). An existing store is never overwritten. - configuration.yaml is seeded once (
seedConfiguration). After the first start the file is yours; the chart never overwrites it. Edit it withkubectl -n homeassistant exec -it deploy/homeassistant -- vi /config/configuration.yamland 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 setprivileged: 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
- Open https://homeassistant.smokyzone.de and create the owner account during onboarding (first visitor becomes the owner, so do this right away).
- Home location / units / language (Deutsch) in the onboarding wizard.
- Companion app: server URL
https://homeassistant.smokyzone.de(works at home and via Tailscale).
Upgrades
Bump image.tag in values.yaml (see the release notes for breaking changes first).
Languages
Go Template
100%