ESPHome (Direct Mode)

🇩🇪 Deutsch

Direct integration with ESPHome devices — without Home Assistant as intermediary. Multi-instance (one per device).

What the integration can do

• Live sensor values (temperature, brightness, voltage — whatever is in the YAML)
• Binary sensors (on/off)
• Text sensors
• Auto-detection of whether the device speaks v3 (modern framework, SSE stream) or v2 (classic REST)

Prerequisites

• ESPHome device with the web_server: component in the YAML, e.g.:

  web_server:
    port: 80
    version: 3   # or 2

• Optional: API password if api: { password: "..." } is in the YAML

Setup in Mesh

Admin → Integrations → ESPHome → "Add":

• label — e.g. "Heating ESP"
• baseUrl — e.g. http://esp-livingroom.local or http://192.168.1.50
• password (optional) — Basic Auth if API password is set

Using the widget

Admin → Content → Widgets → "ESPHome". Settings:

• integrationIds[] — one or more devices
• With multiple: one block per device, each collapsible

v3 vs v2 — what is the difference?

Important: Mesh uses node:http directly for v3 SSE (not fetch()), because Next.js Node runtime buffers SSE responses.

Troubleshooting

• "No data" → web_server: component missing in YAML. Recompile + flash ESPHome
• "Connection refused" on port 80 → port changed? port: 8080 in YAML, then add port to baseUrl
• *`.local` (mDNS) does not work** in the container — use an IP instead of hostname
• API password forgotten → re-flash ESPHome via OTA update with new YAML

API endpoints (for debugging)