feat: Update README with additional charts and enhance documentation for Home Assistant and ESPHome

README.md

@@ -4,7 +4,7 @@ A collection of custom and optimized Helm charts for self-hosted applications on
 
 ## Repository Structure
 
-- `/charts`: Individual application charts (e.g. `jellyfin`).
+- `/<chart-name>`: Individual application charts (e.g. `jellyfin`, `home-assistant`, `esphome`).
 - `/docs`: Detailed application documentation and guides.
 
 ## Quick Start
@@ -20,6 +20,8 @@ cd helm-charts
 | Chart | Description | Status |
 |-------|-------------|--------|
 | [Jellyfin](docs/jellyfin.md) | Media server with PostgreSQL support | Ready |
+| [Home Assistant](docs/home-assistant.md) | Home automation with PostgreSQL recorder and managed secrets | Ready |
+| [ESPHome](docs/esphome.md) | ESPHome dashboard with host network for device discovery | Ready |
 
 ### 3. Usage with FluxCD
 

docs/esphome.md

@@ -0,0 +1,32 @@
+# ESPHome Helm Chart
+
+A Helm chart for ESPHome dashboard with host network support for device discovery.
+
+## Features
+- **Host Network**: Enabled by default for mDNS device discovery.
+- **Ingress**: Dictionary-based multi-ingress support (e.g. external HTTPS + internal LAN).
+- **Persistence**: Config volume via hostPath.
+
+## Installation
+
+### 1. Configure Values
+Review the [values.yaml](https://github.com/shadoll/helm-charts/blob/main/esphome/values.yaml) and create your override file.
+
+### 2. Install
+```bash
+helm install my-esphome ./esphome -f my-values.yaml
+```
+
+## Configuration Reference
+
+| Parameter | Description | Default |
+|-----------|-------------|---------|
+| `image.repository` | ESPHome image repository | `ghcr.io/esphome/esphome` |
+| `image.pullPolicy` | Image pull policy | `Always` |
+| `timezone` | Container timezone | `Europe/Kyiv` |
+| `usePing` | Use ping for device status | `true` |
+| `hostNetwork` | Enable host networking | `true` |
+| `volume.hostPath` | Host path for config persistence | `""` |
+| `ingresses` | Dictionary of ingress definitions | `{}` |
+
+For detailed configuration, see the [values.yaml](https://github.com/shadoll/helm-charts/blob/main/esphome/values.yaml).

docs/home-assistant.md

@@ -0,0 +1,80 @@
+# Home Assistant Helm Chart
+
+A Helm chart for Home Assistant with PostgreSQL recorder support, managed secrets, and Kubernetes-native logging.
+
+## Features
+- **PostgreSQL Recorder**: Optional PostgreSQL backend for HA recorder with automated database and user creation via `db-init` job.
+- **Managed Secrets**: HA `secrets.yaml` generated from Kubernetes Secrets (works with sealed-secrets).
+- **Kubernetes-native Logging**: Log file disabled, all logs go to stdout (`kubectl logs`).
+- **Backups**: Integrated CronJob for automated PostgreSQL backups with configurable retention and node pinning.
+- **Ingress**: Dictionary-based multi-ingress support (e.g. external HTTPS + internal LAN).
+- **Host Network**: Enabled by default for mDNS/HomeKit discovery.
+- **Persistence**: Config and media volumes with hostPath or PVC support.
+
+## Installation
+
+### 1. Create Secrets
+
+**PostgreSQL secret** (if using postgres recorder):
+```yaml
+apiVersion: v1
+kind: Secret
+metadata:
+  name: ha-secret
+stringData:
+  HA_POSTGRESQL_PASSWORD: "<password>"
+  POSTGRES_ADMIN_PASSWORD: "<admin-password>"
+```
+
+**HA secrets** (optional, for managing HA `secrets.yaml`):
+```yaml
+apiVersion: v1
+kind: Secret
+metadata:
+  name: ha-ha-secrets
+stringData:
+  api_key: "some-api-key"
+  webhook_token: "some-token"
+```
+
+### 2. Configure Values
+Review the [values.yaml](https://github.com/shadoll/helm-charts/blob/main/home-assistant/values.yaml) and create your override file.
+
+### 3. Install
+```bash
+helm install my-ha ./home-assistant -f my-values.yaml
+```
+
+## Configuration Reference
+
+| Parameter | Description | Default |
+|-----------|-------------|---------|
+| `image.repository` | HA image repository | `ghcr.io/home-assistant/home-assistant` |
+| `image.tag` | HA image tag | (Chart appVersion) |
+| `hostNetwork` | Enable host networking | `true` |
+| `timezone` | Container timezone | `Europe/Kyiv` |
+| `homekit.enabled` | Expose HomeKit port (21063) | `true` |
+| `persistence.config.type` | Config volume type (`hostPath` or `pvc`) | `hostPath` |
+| `persistence.media.enabled` | Enable media volume | `true` |
+| `haSecrets.enabled` | Manage HA secrets.yaml from K8s Secret | `false` |
+| `haSecrets.existingSecret` | K8s Secret name for HA secrets | `""` |
+| `postgres.enabled` | Enable PostgreSQL recorder | `false` |
+| `postgres.host` | PostgreSQL host | `postgres-tcp.postgres.svc.cluster.local` |
+| `postgres.db` | Database name | `homeassistant` |
+| `postgres.user` | Database user | `ha` |
+| `postgres.existingSecret` | K8s Secret with DB credentials | `""` |
+| `dbInit.enabled` | Enable database initialization job | `false` |
+| `backup.enabled` | Enable automated PostgreSQL backups | `false` |
+| `backup.node` | Pin backup CronJob to specific node | `""` |
+
+For detailed configuration, see the [values.yaml](https://github.com/shadoll/helm-charts/blob/main/home-assistant/values.yaml).
+
+## Architecture
+
+### Init Containers
+1. **init-config** (always): Cleans up old log files from PVC.
+2. **init-secrets** (when `haSecrets.enabled`): Generates `/config/secrets.yaml` from K8s Secret key-value pairs.
+3. **init-recorder** (when `postgres.enabled`): Generates `/config/recorder.yaml` with PostgreSQL connection string and appends `recorder: !include recorder.yaml` to `configuration.yaml`.
+
+### Logging
+The container patches the HA s6-overlay run script to pass `--log-file /dev/null`, disabling file-based logging. All logs go to stdout and are accessible via `kubectl logs`.