Installation: Master-Worker Cluster
The master-worker cluster is optional. If your Home Assistant host can run inference on its own, skip this page entirely and use the standard HA OS App installation. Only set up a worker if you want to offload inference to a separate machine.
In this mode the master is the Home Assistant app: it holds the license, integrates with Home Assistant, and serves the Hub UI. A dedicated worker machine runs the AI inference and has the camera connected to it.
Useful when your Home Assistant host is too lightweight for inference, or when you prefer to place the camera close to a separate machine.
- One worker per master.
- One camera in total. Inference runs either on the worker, or on the HAOS host through the Superhome app. The two do not run a camera at the same time.
How to set it up
1. Install the master (HAOS app)
Follow the HA OS App guide. The rtsp_url is still configured on the HAOS app exactly as in the standard installation: the worker reads the camera and other settings from the configuration set on the app in Home Assistant.
In the Configuration tab, set inference_mode to master-worker. This turns the app into a pure Hub and tells it that inference happens on the worker.
2. Add the worker
Go to Add a Worker and follow the steps to pair a worker machine to your master.