mydocker/esphome/README.md

ESPHome - ESP Firmware Dashboard

Web dashboard for compiling firmware and managing ESP8266/ESP32 devices. Provides OTA updates and native API integration with Home Assistant.

Access

Endpoint	Details
Dashboard	http://localhost:6052
Network	network_mode: host (required for OTA + mDNS discovery)

Configuration

• Image: esphome/esphome
• Device YAML: ./esphome/*.yaml
• Secrets: ./esphome/secrets.yaml

Devices

YAML File	Device	Description
sonoff_mini_hall.yaml	Sonoff Mini (ESP8266)	Hallway ceiling light (192.168.20.62)
sonoff_mini_stefi.yaml	Sonoff Mini	Stefi's room light
sonoff_mini_small_hall.yaml	Sonoff Mini	Small hallway
sonoff_mini_driveway.yaml	Sonoff Mini	Driveway light
sonoff-mini-r2-1.yaml	Sonoff Mini R2	Relay #1
sonoff-mini-r2-2.yaml	Sonoff Mini R2	Relay #2
sonoff-mini-digestor.yaml	Sonoff Mini	Kitchen hood
sonoff-mini-kitchen-led.yaml	Sonoff Mini	Kitchen LED strip
sonofft13guk.yaml	Sonoff T1	Touch switch
bathroom-shelly-1l-01.yaml	Shelly 1L	Bathroom light
light_driveway.yaml	ESP (custom)	Smart driveway lighting
esp_mini_office.yaml	ESP32 Mini	Office
esp_woox_dining.yaml	ESP Woox	Dining room
esp_woox_fan.yaml	ESP Woox	Fan
lsmin-gat/	LSMini	Gate

All devices connect via WiFi IoT network (VLAN 20, wifi_ssid_iot) with WPA2 and have a fallback AP.

Architecture

ESPHome Dashboard
  ├── Compiles firmware and flashes OTA to ESP devices
  ├── Devices report states to Home Assistant via native API
  └── Some devices also communicate via MQTT (Mosquitto)

Useful Commands

# Follow dashboard logs
docker compose logs -f esphome

# Restart
docker compose restart esphome

# Compile and flash firmware from CLI
docker compose exec esphome esphome run /config/sonoff_mini_hall.yaml