Manage the Worker
In Hub → Cluster you can:
- See the worker's status (online/offline), its last contact time, and the camera it's reading.
- Approve a newly enrolled worker so it can start running inference.
- Revoke the worker. It will be disconnected and blocked until it re-enrolls with a new enrollment key.
You configure everything (camera URL, timing, sensitivity, and so on) in the Configuration tab of the Superhome app in Home Assistant. When you save there, the settings are also sent to the connected worker. To be sure the changes take full effect on the worker, restart the worker container afterwards:
docker compose restart
Updating the worker
To update the worker to the latest image, run these two commands from the folder that holds docker-compose.yml:
docker compose pull
docker compose up -d
pull downloads the new image while the current worker keeps running; up -d then recreates the container only if the image actually changed. There is no need to run docker compose down first; it would only add downtime. The worker reconnects to the master on its own: no new PIN is needed and its data volume is preserved.
Pointing the worker at a different master
Changing SUPERHOME_MASTER_HOST alone does not switch the master: the cached pairing with the previous master takes precedence. First reset the worker's pairing by recreating the worker container with a fresh data volume, then enroll it against the new master with a new enrollment key.