Operations¶
Logs¶
ModelDeck logs to stdout. Sensitive values are redacted.
Poll interval¶
Default: 300 seconds (minimum 60). Increase if providers rate-limit your account.
State cache¶
Last-good snapshots are stored when service.retain_state is true:
| Deployment | Path |
|---|---|
| Docker Compose | /data/state.json (bind mount) |
| HAOS add-on | /config/data/state.json (add-on config volume) |
Upgrades¶
Stable (recommended):
docker pull ghcr.io/automationnexus/modeldeck:latest
docker compose -f templates/docker-compose.yml up -d
Nightly (dev integration): set IMAGE_TYPE=nightly in .env, then run the same compose command.
Pinned semver: IMAGE_TYPE=v0.0.1 (or newer tag from GitHub Releases).
Troubleshooting¶
| Symptom | Check |
|---|---|
| No HA entities | MQTT broker reachable; mqtt.host correct; discovery prefix homeassistant |
| Gauges show mock data | Disable providers.mock in modeldeck.yaml |
auth_error on status sensor |
Renew token/API key in secrets.yaml; restart container |
parse_error |
Provider API may have changed — check GitHub issues |
rate_limited |
Increase service.poll_interval_seconds |
| Sensors show old "last updated" | Upgrade to v0.1.1+; restart add-on; check logs for MQTT publish failed or Collection cycle failed |
| Collectors failing | Check sensor.modeldeck_{provider}_status in Home Assistant |