# 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/)