troubleshooting

Troubleshooting

Integration not appearing in search

• Make sure you restarted HA after installing
• Check logs: Settings → System → Logs → search docker_manager
• Verify the files are in custom_components/docker_manager/

Cannot connect to remote server

# Test from the HA host
curl http://<server-ip>:2375/version

If this fails:

• Verify TCP is enabled in daemon.json
• Check firewall rules on the remote server
• On Synology: verify DSM firewall allows port 2375 from your LAN

Entities showing unavailable

The coordinator could not reach Docker. Check:

1. docker logs HomeAssistant 2>&1 | grep docker_manager
2. Verify the server IP and port in the integration config
3. For Synology: the dockerd.json may have been reset by a DSM update

Graphs show no data

ApexCharts needs history to draw lines. Wait 15–60 minutes after first setup. If graphs show "Configuration error" — verify the entity IDs in the dashboard match what's in Developer Tools → States.

Container not appearing in dashboard

• Stopped containers with state unknown are excluded by the dashboard filter
• UUID-named containers (orphaned) can be cleaned: docker container prune
• Check Developer Tools → States → search sensor.{servername}_*_state

Logs notification not appearing

Press the 🔔 bell icon in the top-right of HA after pressing Fetch Logs. The notification appears there. Each press replaces the previous log for that container.