Skip to content


esphome logo

Version: 0.14.1 Type: application AppVersion: 2024.3.2

ESPHome is a system to control your ESP8266/ESP32 by simple yet powerful configuration files and control them remotely through Home Automation systems.

This chart is not maintained by the upstream project and any issues with the chart should be raised here

Source Code


Kubernetes: >=1.22.0-0


Repository Name Version common 1.5.1

Installing the Chart

To install the chart with the release name esphome

helm install esphome oci://


helm repo add gabe565
helm repo update
helm install esphome gabe565/esphome

Uninstalling the Chart

To uninstall the esphome deployment

helm uninstall esphome

The command removes all the Kubernetes components associated with the chart including persistent volumes and deletes the release.


Read through the values.yaml file. It has several commented out suggested values. Other values may be used from the values.yaml from the bjw-s common library.

Specify each parameter using the --set key=value[,key=value] argument to helm install.

helm install esphome \
  --set env.TZ="America/New York" \

Alternatively, a YAML file that specifies the values for the above parameters can be provided while installing the chart.

helm install esphome gabe565/esphome -f values.yaml

Custom configuration

Devices Show as offline

ESPHome may have trouble finding your local devices due to your Kubernetes DNS configuration. If so, set the following values:


    # Set to your router IP or local DNS server

dnsPolicy: None


Important: When deploying an application Helm chart you can add more values from the bjw-s common library chart here

Key Type Default Description
addons.codeserver.enabled bool false Enable VS Code server addon. This allows for easy access to device configuration
addons.codeserver.ingress object See values.yaml Enable and configure ingress settings for the VS Code server under this key.
env object See values.yaml Environment variables.
image.pullPolicy string "IfNotPresent" image pull policy
image.repository string "" image repository
image.tag string "2024.3.2" image tag
ingress.main object See values.yaml Enable and configure ingress settings for the chart under this key.
persistence object See values.yaml Configure persistence settings for the chart under this key.
service object See values.yaml Configures service settings for the chart.

Autogenerated from chart metadata using helm-docs