poprhythm
2d91aab062
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
69 lines
1.9 KiB
Markdown
69 lines
1.9 KiB
Markdown
# 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/)
|