From 2d91aab062b8ea6032fe7204fef1808d87beff33 Mon Sep 17 00:00:00 2001
From: poprhythm <james.kolpack@gmail.com>
Date: Mon, 9 Feb 2026 15:44:04 +0000
Subject: [PATCH] Add Home Assistant setup

Home automation platform for smart home device integration. Configured with:
- nginx reverse proxy integration at homeassistant.kolpacksoftware.com
- Data persistence at /srv/home-assistant
- Privileged mode for device access
---
 home-assistant/README.md          | 68 +++++++++++++++++++++++++++++++
 home-assistant/docker-compose.yml | 21 ++++++++++
 2 files changed, 89 insertions(+)
 create mode 100644 home-assistant/README.md
 create mode 100644 home-assistant/docker-compose.yml

diff --git a/home-assistant/README.md b/home-assistant/README.md
new file mode 100644
index 0000000..2d14132
--- /dev/null
+++ b/home-assistant/README.md
@@ -0,0 +1,68 @@
+# Home Assistant
+
+Home automation platform that integrates with hundreds of smart home devices and services.
+
+## Access
+
+- **URL**: https://homeassistant.kolpacksoftware.com
+- **Local**: http://localhost:8123 (if needed)
+
+## Initial Setup
+
+1. Navigate to the URL above
+2. Create your admin account on first launch
+3. Follow the onboarding wizard to:
+   - Set your location
+   - Choose initial integrations
+   - Configure devices
+
+## Configuration
+
+- **Data directory**: `/srv/home-assistant/`
+- **Config file**: `/srv/home-assistant/configuration.yaml`
+- **Logs**: `docker logs home-assistant`
+
+## Network Considerations
+
+The container runs on `npm-network` and connects through the nginx reverse proxy.
+
+**For device discovery**: Some integrations (like HomeKit, mDNS-based devices) work best with host networking. If you encounter discovery issues:
+
+1. Stop the container via Portainer
+2. Edit `docker-compose.yml` and replace the networks section with:
+   ```yaml
+   network_mode: host
+   ```
+3. Remove the VIRTUAL_HOST environment variables (not needed with host mode)
+4. Redeploy via Portainer
+5. Configure nginx-proxy-manager manually to proxy to localhost:8123
+
+## Common Integrations
+
+- **Smart lights**: Philips Hue, LIFX, TP-Link
+- **Smart speakers**: Google Home, Alexa
+- **IoT devices**: Zigbee, Z-Wave, MQTT
+- **Media**: Plex, Sonos, Chromecast
+- **Weather, calendars, notifications**: Many built-in integrations
+
+## Useful Commands
+
+```bash
+# View logs
+docker logs -f home-assistant
+
+# Restart container
+docker restart home-assistant
+
+# Check configuration
+docker exec home-assistant hass --script check_config
+
+# Access container shell
+docker exec -it home-assistant /bin/bash
+```
+
+## Resources
+
+- [Official Documentation](https://www.home-assistant.io/docs/)
+- [Community Forum](https://community.home-assistant.io/)
+- [Integrations List](https://www.home-assistant.io/integrations/)
diff --git a/home-assistant/docker-compose.yml b/home-assistant/docker-compose.yml
new file mode 100644
index 0000000..fcd057b
--- /dev/null
+++ b/home-assistant/docker-compose.yml
@@ -0,0 +1,21 @@
+networks:
+  default:
+    external:
+      name: npm-network
+
+services:
+  homeassistant:
+    image: ghcr.io/home-assistant/home-assistant:stable
+    container_name: home-assistant
+    volumes:
+      - /srv/home-assistant:/config
+      - /etc/localtime:/etc/localtime:ro
+    environment:
+      - PUID=1000
+      - PGID=1000
+      - TZ=America/New_York
+      - VIRTUAL_HOST=homeassistant.kolpacksoftware.com
+      - VIRTUAL_PORT=8123
+      - LETSENCRYPT_HOST=homeassistant.kolpacksoftware.com
+    restart: unless-stopped
+    privileged: true