Home Assistant Local Development Environment

This project sets up a local development environment for Home Assistant, allowing integration with various devices and services. It uses Docker Compose to orchestrate multiple containers, providing a comprehensive setup for testing and development.

Components

• Home Assistant: The core home automation platform.
• Mosquitto: An MQTT broker for device communication.
• Ecowitt2MQTT: A bridge for Ecowitt-compatible weather stations.
• InfluxDB: Time series database for storing sensor data.
• Grafana: Data visualization and monitoring tool.
• Weather Emulator: A custom service that generates mock weather data.

Prerequisites

• Git
• Docker
• Docker Compose

Setup

Install requirements

macOS

brew install git
brew install --cask docker

Linux

sudo apt-get update
sudo apt-get install git docker.io docker-compose

Windows

It's recommended to use Chocolatey to install dependencies like Git on Windows.

• Install Chocolatey: Open PowerShell as an Administrator and run:

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

• Install Git using Chocolatey: After Chocolatey is installed, run:

choco install git -y

• Install Docker Desktop: You can also use Chocolatey to install Docker Desktop:

choco install docker-desktop -y

• Verify the installations:

git --version
docker --version

Start composition

1. Clone this repository:

git clone https://github.com/adomenech73/home-assistant-ldenv
cd home-assistant-ldenv

2. Build and start the services:

docker-compose up -d

Accessing Services

• Home Assistant: http://localhost:8123
• Grafana: http://localhost:3000
• InfluxDB: http://localhost:8086

Configuration

• Home Assistant configuration files are located in ./ha/config/.
• Mosquitto configuration is in ./mqtt/config/mosquitto.conf.
• InfluxDB data is stored in ./influxdb/.
• Grafana data is stored in ./grafana/.

Weather Emulator

The Weather Emulator service generates mock weather data and publishes it to MQTT. You can configure its behavior using environment variables in the docker-compose.yml file.

Customization

• Modify the docker-compose.yml file to add or remove services as needed.
• Adjust volume mappings to persist data or configurations.
• Add additional devices or integrations by extending the Home Assistant configuration.

Troubleshooting

• Check container logs: docker-compose logs [service_name]
• Ensure all required ports are available on your host machine.
• Verify network connectivity between containers.

Contributing

Contributions to improve this setup are welcome. Please submit pull requests or open issues for any enhancements or bug fixes.

License

MIT License