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
2026-02-09 15:44:04 +00:00
parent f0902944e0
commit 2d91aab062
2 changed files with 89 additions and 0 deletions
@@ -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/)