homeassistant-operator

module

v1.4.1 Latest Latest Go to latest Published: Sep 4, 2026 License: Apache-2.0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/przemekhys/homeassistant-operator

Links

Open Source Insights

README ¶

Home Assistant Operator

A Kubernetes operator for deploying and managing Home Assistant instances with declarative configuration, zero-touch bootstrap, and GitOps-ready automations.

Full documentation →

Release artifacts (container image, Helm chart) are keylessly signed — see Signed Releases to verify them or enforce verification in your cluster with Kyverno.

Quick Start

helm install homeassistant-operator oci://ghcr.io/przemekhys/charts/homeassistant-operator \
  --namespace homeassistant-operator-system \
  --create-namespace \
  --set 'watchNamespaces={homeassistant}'

watchNamespaces lists the namespaces holding your Home Assistant resources. Omitting it gives the operator cluster-wide permissions, which is deprecated.

See the installation guide for a full walkthrough, including the plain-manifest (kustomize) alternative.

Contributing

See CONTRIBUTING.md or the contributing guide.

Acknowledgments

Home Assistant - The amazing home automation platform
Operator SDK - Framework for building Kubernetes operators
Kubebuilder - SDK for building Kubernetes APIs
cert-controller (OPA) - Self-managed rotation of the webhook serving certificate, so the operator needs no cert-manager

License

Licensed under the Apache License, Version 2.0. See LICENSE for details.

Directories ¶

Path	Synopsis
api
v1 Package v1 contains API Schema definitions for the ha v1 API group.	Package v1 contains API Schema definitions for the ha v1 API group.
v1alpha1 Package v1alpha1 contains API Schema definitions for the ha v1alpha1 API group.	Package v1alpha1 contains API Schema definitions for the ha v1alpha1 API group.
cmd
internal
communityrepo Package communityrepo validates and resolves HACS-compatible GitHub repositories (fetch, hacs.json/manifest parsing, install-target resolution).	Package communityrepo validates and resolves HACS-compatible GitHub repositories (fetch, hacs.json/manifest parsing, install-target resolution).
controller
haclient
version Package version contains version information for the operator.	Package version contains version information for the operator.
webhook/v1
test
utils

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL