Add Home Assistant chart
Co-Authored-By: Claude Opus 5.5 <[email protected]>
This commit is contained in:
+14
@@ -0,0 +1,14 @@
|
||||
apiVersion: v2
|
||||
name: homeassistant
|
||||
description: Home Assistant (container install) on the home cluster
|
||||
type: application
|
||||
version: 0.1.0
|
||||
appVersion: "2026.10.2"
|
||||
home: https://git.smokyzone.de/SmokyZone/homeassistant-gitops
|
||||
sources:
|
||||
- https://git.smokyzone.de/SmokyZone/homeassistant-gitops
|
||||
keywords:
|
||||
- home-assistant
|
||||
- smart-home
|
||||
maintainers:
|
||||
- name: SmokyZone
|
||||
@@ -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).
|
||||
@@ -0,0 +1,10 @@
|
||||
{{- define "ha.labels" -}}
|
||||
app.kubernetes.io/name: homeassistant
|
||||
app.kubernetes.io/instance: {{ .Release.Name }}
|
||||
app.kubernetes.io/managed-by: {{ .Release.Service }}
|
||||
{{- end }}
|
||||
|
||||
{{- define "ha.selectorLabels" -}}
|
||||
app.kubernetes.io/name: homeassistant
|
||||
app.kubernetes.io/instance: {{ .Release.Name }}
|
||||
{{- end }}
|
||||
@@ -0,0 +1,9 @@
|
||||
apiVersion: v1
|
||||
kind: ConfigMap
|
||||
metadata:
|
||||
name: homeassistant-seed
|
||||
labels:
|
||||
{{- include "ha.labels" . | nindent 4 }}
|
||||
data:
|
||||
configuration.yaml: |
|
||||
{{- .Values.seedConfiguration | nindent 4 }}
|
||||
@@ -0,0 +1,82 @@
|
||||
apiVersion: apps/v1
|
||||
kind: Deployment
|
||||
metadata:
|
||||
name: homeassistant
|
||||
labels:
|
||||
{{- include "ha.labels" . | nindent 4 }}
|
||||
spec:
|
||||
replicas: 1
|
||||
# RWO volume + hostNetwork port: the old pod must be gone before the new one starts.
|
||||
strategy:
|
||||
type: Recreate
|
||||
selector:
|
||||
matchLabels:
|
||||
{{- include "ha.selectorLabels" . | nindent 6 }}
|
||||
template:
|
||||
metadata:
|
||||
labels:
|
||||
{{- include "ha.selectorLabels" . | nindent 8 }}
|
||||
spec:
|
||||
hostNetwork: {{ .Values.hostNetwork }}
|
||||
# Keep cluster DNS (service names) working with hostNetwork.
|
||||
dnsPolicy: {{ ternary "ClusterFirstWithHostNet" "ClusterFirst" .Values.hostNetwork }}
|
||||
initContainers:
|
||||
# Seed configuration.yaml (incl. reverse-proxy settings) on first start only.
|
||||
- name: seed-config
|
||||
image: busybox:1.36
|
||||
command:
|
||||
- sh
|
||||
- -c
|
||||
- |
|
||||
set -e
|
||||
if [ ! -f /config/configuration.yaml ]; then
|
||||
cp /seed/configuration.yaml /config/configuration.yaml
|
||||
echo "seeded configuration.yaml"
|
||||
fi
|
||||
# Files included by the seeded configuration.yaml (same defaults as HA's onboarding).
|
||||
[ -f /config/automations.yaml ] || echo "[]" > /config/automations.yaml
|
||||
touch /config/scripts.yaml /config/scenes.yaml
|
||||
mkdir -p /config/themes
|
||||
volumeMounts:
|
||||
- {name: config, mountPath: /config}
|
||||
- {name: seed, mountPath: /seed}
|
||||
containers:
|
||||
- name: homeassistant
|
||||
image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
|
||||
env:
|
||||
- name: TZ
|
||||
value: {{ .Values.tz | quote }}
|
||||
ports:
|
||||
- name: http
|
||||
containerPort: {{ .Values.port }}
|
||||
{{- if .Values.privileged }}
|
||||
securityContext:
|
||||
privileged: true
|
||||
{{- end }}
|
||||
startupProbe:
|
||||
tcpSocket: {port: http}
|
||||
periodSeconds: 10
|
||||
failureThreshold: 60
|
||||
livenessProbe:
|
||||
tcpSocket: {port: http}
|
||||
periodSeconds: 30
|
||||
failureThreshold: 5
|
||||
resources:
|
||||
{{- toYaml .Values.resources | nindent 12 }}
|
||||
volumeMounts:
|
||||
- {name: config, mountPath: /config}
|
||||
{{- range $i, $d := .Values.devices }}
|
||||
- {name: dev-{{ $i }}, mountPath: {{ $d }}}
|
||||
{{- end }}
|
||||
volumes:
|
||||
- name: config
|
||||
persistentVolumeClaim:
|
||||
claimName: homeassistant-config
|
||||
- name: seed
|
||||
configMap:
|
||||
name: homeassistant-seed
|
||||
{{- range $i, $d := .Values.devices }}
|
||||
- name: dev-{{ $i }}
|
||||
hostPath:
|
||||
path: {{ $d }}
|
||||
{{- end }}
|
||||
@@ -0,0 +1,29 @@
|
||||
{{- if .Values.ingress.enabled }}
|
||||
apiVersion: networking.k8s.io/v1
|
||||
kind: Ingress
|
||||
metadata:
|
||||
name: homeassistant
|
||||
labels:
|
||||
{{- include "ha.labels" . | nindent 4 }}
|
||||
annotations:
|
||||
cert-manager.io/cluster-issuer: {{ .Values.ingress.clusterIssuer }}
|
||||
{{- with .Values.ingress.annotations }}
|
||||
{{- toYaml . | nindent 4 }}
|
||||
{{- end }}
|
||||
spec:
|
||||
ingressClassName: {{ .Values.ingress.className }}
|
||||
tls:
|
||||
- hosts: [{{ .Values.ingress.host }}]
|
||||
secretName: homeassistant-tls
|
||||
rules:
|
||||
- host: {{ .Values.ingress.host }}
|
||||
http:
|
||||
paths:
|
||||
- path: /
|
||||
pathType: Prefix
|
||||
backend:
|
||||
service:
|
||||
name: homeassistant
|
||||
port:
|
||||
name: http
|
||||
{{- end }}
|
||||
@@ -0,0 +1,18 @@
|
||||
apiVersion: v1
|
||||
kind: PersistentVolumeClaim
|
||||
metadata:
|
||||
name: homeassistant-config
|
||||
labels:
|
||||
{{- include "ha.labels" . | nindent 4 }}
|
||||
annotations:
|
||||
# Never delete the config (users, integrations, history) on uninstall/prune.
|
||||
helm.sh/resource-policy: keep
|
||||
argocd.argoproj.io/sync-options: Delete=false
|
||||
spec:
|
||||
accessModes: [ReadWriteOnce]
|
||||
{{- with .Values.persistence.storageClassName }}
|
||||
storageClassName: {{ . }}
|
||||
{{- end }}
|
||||
resources:
|
||||
requests:
|
||||
storage: {{ .Values.persistence.size }}
|
||||
@@ -0,0 +1,13 @@
|
||||
apiVersion: v1
|
||||
kind: Service
|
||||
metadata:
|
||||
name: homeassistant
|
||||
labels:
|
||||
{{- include "ha.labels" . | nindent 4 }}
|
||||
spec:
|
||||
selector:
|
||||
{{- include "ha.selectorLabels" . | nindent 4 }}
|
||||
ports:
|
||||
- name: http
|
||||
port: {{ .Values.port }}
|
||||
targetPort: http
|
||||
+60
@@ -0,0 +1,60 @@
|
||||
## Values for the Home Assistant chart.
|
||||
|
||||
image:
|
||||
repository: ghcr.io/home-assistant/home-assistant
|
||||
tag: "2026.10.2"
|
||||
|
||||
tz: Europe/Berlin
|
||||
|
||||
# Run in the node's network namespace. Required for LAN discovery (mDNS/SSDP:
|
||||
# Chromecast, Hue, Sonos, HomeKit, ...), which does not cross the pod network.
|
||||
# Side effect: port 8123 (plain HTTP) is also open on the node's LAN IP.
|
||||
hostNetwork: true
|
||||
|
||||
port: 8123
|
||||
|
||||
persistence:
|
||||
# /config: configuration.yaml, .storage (users, integrations), SQLite recorder DB.
|
||||
size: 5Gi
|
||||
storageClassName: ""
|
||||
|
||||
# Written to /config/configuration.yaml on first start only (when the file does not
|
||||
# exist yet). Afterwards the file belongs to you; the chart never overwrites it.
|
||||
# The http block lets HA accept requests from ingress-nginx (pod network 10.1.0.0/16);
|
||||
# without it HA answers 400 Bad Request to proxied requests.
|
||||
seedConfiguration: |
|
||||
# Loads the default set of integrations. Do not remove.
|
||||
default_config:
|
||||
|
||||
http:
|
||||
use_x_forwarded_for: true
|
||||
trusted_proxies:
|
||||
- 10.1.0.0/16
|
||||
- 127.0.0.1
|
||||
|
||||
frontend:
|
||||
themes: !include_dir_merge_named themes
|
||||
|
||||
automation: !include automations.yaml
|
||||
script: !include scripts.yaml
|
||||
scene: !include scenes.yaml
|
||||
|
||||
ingress:
|
||||
enabled: true
|
||||
className: nginx
|
||||
# ingress-nginx is NodePort-only: https://homeassistant.smokyzone.de:30444
|
||||
host: homeassistant.smokyzone.de
|
||||
clusterIssuer: letsencrypt-dns-cloudflare
|
||||
annotations:
|
||||
# Websocket connection of the frontend / companion app stays open.
|
||||
nginx.ingress.kubernetes.io/proxy-read-timeout: "3600"
|
||||
nginx.ingress.kubernetes.io/proxy-send-timeout: "3600"
|
||||
nginx.ingress.kubernetes.io/proxy-body-size: 100m
|
||||
|
||||
# USB radios (Zigbee/Z-Wave sticks), e.g. /dev/serial/by-id/usb-...; needs privileged.
|
||||
devices: []
|
||||
privileged: false
|
||||
|
||||
resources:
|
||||
requests: {cpu: 100m, memory: 512Mi}
|
||||
limits: {cpu: "2", memory: 2Gi}
|
||||
Reference in New Issue
Block a user