How to Install Home Assistant on Your Breeze

How to Install Home Assistant on Your Breeze

Home Assistant is the leading open-source platform for home automation. While it is commonly run on local hardware like a Raspberry Pi, running Home Assistant on your Breeze provides remote access, reliable uptime, and more processing power for complex automations. It integrates with over 2,000 smart home devices and services, letting you build a unified control center for your entire home.

Prerequisites

• A Breeze instance with at least 2 GB of RAM
• Docker and Docker Compose installed
• A domain or subdomain (e.g., home.example.com)
• Smart home devices on your local network (optional — you can start with cloud-based integrations)

Step 1 — Deploy Home Assistant Container

Create a directory and deploy Home Assistant using Docker:

mkdir -p ~/homeassistant && cd ~/homeassistant
cat > docker-compose.yml <<'EOF'
version: "3.8"
services:
  homeassistant:
    image: ghcr.io/home-assistant/home-assistant:stable
    restart: unless-stopped
    network_mode: host
    environment:
      TZ: America/New_York
    volumes:
      - ./config:/config
EOF
docker compose up -d

Home Assistant will be accessible on port 8123 after about two minutes of initial setup.

Step 2 — Initial Onboarding

Navigate to http://your-breeze-ip:8123 and create your owner account. Home Assistant will automatically detect some integrations and guide you through basic configuration including your location, unit system, and currency preferences.

Step 3 — Reverse Proxy for Remote Access

Configure Nginx to proxy Home Assistant with WebSocket support:

server {
    listen 443 ssl http2;
    server_name home.example.com;

    location / {
        proxy_pass http://127.0.0.1:8123;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

Then add the following to your Home Assistant configuration.yaml to trust the proxy:

http:
  use_x_forwarded_for: true
  trusted_proxies:
    - 127.0.0.1

Step 4 — Adding Integrations

Go to Settings → Devices & Services → Add Integration to connect your smart home devices. Popular integrations include:

• MQTT — for Zigbee/Z-Wave devices via bridges like Zigbee2MQTT
• Weather services — get local forecasts and conditions
• Media players — control Sonos, Chromecast, and other streaming devices
• Notifications — send alerts via the companion app, email, or Telegram
• Energy monitoring — track power consumption and solar production

Step 5 — Building Automations

Home Assistant automations consist of triggers, conditions, and actions. Create them through the visual editor under Settings → Automations. For example, you can create an automation that turns on lights at sunset, sends a notification when a door sensor is triggered, or adjusts the thermostat based on your phone's location.

Cloud vs. Local Considerations

Running Home Assistant on a Breeze works best for cloud-connected devices and remote monitoring dashboards. For local-only devices like Zigbee or Z-Wave sensors, you will need a local hub at home that connects to your cloud-hosted Home Assistant instance via a VPN tunnel or MQTT bridge.