Files
homeassistant-gitops/README.md
T
2026-10-18 14:01:34 +02:00

2.1 KiB

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: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:

    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).