A self-hosted smart home platform built with ESPHome, Home Assistant, and Docker. Includes MQTT communication, Zigbee lighting, custom automations, and ESP-based curtain, air, and boiler controls — all running on local hardware and designed to be modular and hackable.
This project is a self-contained home automation system using:
- Home Assistant as the control hub
- Docker for service isolation (media, file sync, automation)
- ESP-based microcontrollers for physical sensors and actuators
- MQTT for real-time device communication
- Zigbee integration for lighting control
- Custom hardware (3D-printed and soldered) for enhanced functionality
- Home Assistant running in Docker
- Nextcloud and Jellyfin also containerized
- ESPHome-powered devices:
- Automated curtains (stepper motors + ESP32)
- Boiler interlock safety system
- Air quality monitors
- Mistifiers triggered by local humidity
- MQTT-based messaging across all devices
- Zigbee2MQTT integration (IKEA Tradfri lighting)
- Custom Raspberry Pi security system:
- Camera stream
- Magnetic door sensor
- Alarm trigger and Home Assistant alert
- Docker and Docker Compose
- Home Assistant
- ESPHome (ESP32 and ESP8266)
- MQTT (via Mosquitto)
- Python (for custom automation logic)
- YAML (for configuration and automation)
- Zigbee (via Zigbee2MQTT)
- ESP devices send sensor data via MQTT
- Home Assistant listens and triggers responses
- Docker containers isolate services (Nextcloud, Jellyfin, HA)
- Raspberry Pi handles local camera and door sensors
- Zigbee devices integrated through a USB stick and MQTT bridge
- Clone the repository
- Install Docker and Docker Compose
- Set up MQTT broker (Mosquitto)
- Flash ESP devices using configs in the
/esphomedirectory - Start Home Assistant with the
/home-assistantconfiguration - Customize to match your hardware layout and preferences
- Raspberry Pi 3 – handles alarm system and camera stream
- ESP32 and ESP8266 microcontrollers – for custom sensors and actuators
- Zigbee USB dongle – for IKEA Tradfri and Zigbee2MQTT integration
- IKEA Tradfri lights and buttons
- 3D printed components – curtain motor mounts, sensor enclosures
- Custom relay boards – for boiler control and mistifier automation
- Home server:
- AMD Ryzen 1600X
- NVIDIA GTX 960 GPU
- 2 × 1 Gbps Ethernet ports (bonded via LACP)
- Connected to Ubiquiti 1 Gbps managed switch
- Grafana dashboard for real-time data visualization
- WireGuard or ZeroTier VPN for secure remote access
- Voice assistant integration (e.g. Mycroft or offline Whisper-based control)
- Auto-backup system for configurations and logs
This project is experimental and constantly evolving. Designed for hands-on learning, privacy, and control. Open to suggestions or collaboration.