docker-infrastructure/home-assistant/README.md

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:

   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

# 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
• Community Forum
• Integrations List