feat: Added stuff

homeassistant/README.md

@@ -255,19 +255,62 @@ filter:
 
 ## Troubleshooting
 
+### Docker Networking Issues
+
+**Most Common Issue**: If you're running Home Assistant in Docker and getting connection timeouts:
+
+1. **Use Docker host networking**:
+   - Replace `localhost` with `host.docker.internal` (Docker Desktop)
+   - Or use your host machine's IP address (e.g., `192.168.1.100`)
+   - Or add `--network host` to your Docker run command
+
+2. **Docker Compose example**:
+   ```yaml
+   version: '3'
+   services:
+     homeassistant:
+       container_name: homeassistant
+       image: ghcr.io/home-assistant/home-assistant:stable
+       volumes:
+         - ./config:/config
+       environment:
+         - TZ=America/New_York
+       ports:
+         - "8123:8123"
+       extra_hosts:
+         - "host.docker.internal:host-gateway"  # For Docker on Linux
+   ```
+
+3. **Testing connectivity from Docker**:
+   ```bash
+   # From inside the Home Assistant container:
+   docker exec -it homeassistant curl http://host.docker.internal:3000/health
+   
+   # Or test with your host IP:
+   docker exec -it homeassistant curl http://192.168.1.100:3000/health
+   ```
+
 ### Connection Issues
 
 1. **Cannot connect to server**:
+   - **Docker users**: Use `host.docker.internal` instead of `localhost`
    - Verify the Hyprmonitors server is running: `curl http://localhost:3000/health`
    - Check host and port configuration
-   - Ensure firewall allows connections
+   - Ensure firewall allows connections on port 3000
 
-2. **Monitors not detected**:
+2. **Timeout errors in logs**:
+   - Check if Home Assistant is in Docker (see Docker section above)
+   - Verify network connectivity between Home Assistant and hyprmonitors server
+   - Check if firewall is blocking port 3000
+   - Try increasing timeout in integration settings
+
+3. **Monitors not detected**:
    - Check if Hyprland is running
    - Verify monitors are detected: `hyprctl monitors`
    - Restart the Hyprmonitors server
+   - Check server logs for errors
 
-3. **Integration not loading**:
+4. **Integration not loading**:
    - Check Home Assistant logs for errors
    - Verify all files are copied correctly
    - Restart Home Assistant completely