History

blasebast 9b069a15c4 docs: improve all README files, add uptime-kuma		2026-04-12 20:11:50 +02:00
..
archive	.gitignore, documentation, other improvements	2026-04-04 21:45:48 +02:00
esp32	.gitignore, documentation, other improvements	2026-04-04 21:45:48 +02:00
packages	Add pre-commit with detect-secrets, ignore gitea runtime data	2026-04-11 10:34:50 +02:00
.gitignore	.gitignore, documentation, other improvements	2026-04-04 21:45:48 +02:00
README.md	docs: improve all README files, add uptime-kuma	2026-04-12 20:11:50 +02:00
bathroom-shelly-1l-01.yaml	Add pre-commit with detect-secrets, ignore gitea runtime data	2026-04-11 10:34:50 +02:00
esp_mini_office.yaml	Add pre-commit with detect-secrets, ignore gitea runtime data	2026-04-11 10:34:50 +02:00
esp_woox_dining.yaml	Add pre-commit with detect-secrets, ignore gitea runtime data	2026-04-11 10:34:50 +02:00
esp_woox_fan.yaml	Add pre-commit with detect-secrets, ignore gitea runtime data	2026-04-11 10:34:50 +02:00
light_driveway.yaml	Add pre-commit with detect-secrets, ignore gitea runtime data	2026-04-11 10:34:50 +02:00
sonoff-mini-digestor.yaml	Add pre-commit with detect-secrets, ignore gitea runtime data	2026-04-11 10:34:50 +02:00
sonoff-mini-kitchen-led.yaml	Add pre-commit with detect-secrets, ignore gitea runtime data	2026-04-11 10:34:50 +02:00
sonoff-mini-r2-1.yaml	Add pre-commit with detect-secrets, ignore gitea runtime data	2026-04-11 10:34:50 +02:00
sonoff-mini-r2-2.yaml	Add pre-commit with detect-secrets, ignore gitea runtime data	2026-04-11 10:34:50 +02:00
sonoff_mini_bedroom.yaml	Add pre-commit with detect-secrets, ignore gitea runtime data	2026-04-11 10:34:50 +02:00
sonoff_mini_hall.yaml	Add pre-commit with detect-secrets, ignore gitea runtime data	2026-04-11 10:34:50 +02:00
sonoff_mini_stefi.yaml	Add pre-commit with detect-secrets, ignore gitea runtime data	2026-04-11 10:34:50 +02:00
sonofft13guk.yaml	Add pre-commit with detect-secrets, ignore gitea runtime data	2026-04-11 10:34:50 +02:00

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