Kubernetes Supervisor - Easy HomeAssistant and Add-ons on Kubernetes

shantur · February 4, 2026, 10:52am

Hi all,

For long I had been missing a Supervisor for Kubernetes to run Home Assistant on Kubernetes easily.

github.com/shantur/homeassistant-k8s-supervisor

README-kube.md

90b6aa73e

# Home Assistant Supervisor on Kubernetes (Manifest Setup)

This repository is a fork of the upstream Home Assistant Supervisor.
It contains an experimental Kubernetes runtime backend that can manage add-ons on Kubernetes.

This document describes how to deploy Supervisor using the provided manifest
`ha-k8s-supervised.yaml`.

## What This Deploys

`ha-k8s-supervised.yaml` deploys **Supervisor only**:

- `persistentvolumeclaim/ha-shared-rwx` (shared RWX storage)
- `service/supervisor` (ClusterIP, port 80)
- `statefulset/supervisor` (Supervisor pod, Kubernetes runtime mode)

Supervisor then manages:

- Add-ons (as Deployments)
- Internal L4 port exposure for add-ons via:

This file has been truncated. show original

Configure Namespace + Provide a Service account
Install the Supervisor on your Kubernetes Cluster and it will automatically install

Home Assistant Core
Any Add-ons you add via Home Assistant