Skip to main content

Connect Home Assistant

Home Assistant is optional. Toposync can be used independently, but connecting Home Assistant lets you place entities and states inside the composition.

During alpha, start with non-critical entities and test in a contained environment. Do not use Toposync as the only control path for locks, alarms, gates, emergency workflows, or safety-critical automations.

What the integration is useful for​

Use Home Assistant integration when you want to:

  • see lights, switches, sensors, covers, and other entities in the spatial view;
  • control related devices while looking at a camera or area;
  • use visual events as context for notifications or automations;
  • connect camera intelligence with existing Home Assistant devices.

Start with a small set​

For the first test, add only a few entities:

  • one light;
  • one switch;
  • one sensor;
  • one cover, gate, or garage entity if it is safe to test;
  • one camera-related entity, if available.

This makes it easier to validate names, placement, and behavior before adding a full Home Assistant installation.

Placement tips​

  • Place entities near the real object or area they represent.
  • Use clear names that match what you see in Home Assistant.
  • Keep controls for risky devices separate from casual testing.
  • Verify behavior in Home Assistant directly before trusting a control from Toposync.

Home Assistant add-on​

If you run Toposync as a Home Assistant add-on, the add-on can use supervised execution, sidebar ingress, and internal access to the Home Assistant Core API.

See Home Assistant add-on installation for setup details.

Cameras and Home Assistant Cloud​

There are two camera surfaces:

  • the Toposync sidebar player, used to configure and debug Toposync;
  • native Home Assistant camera.* entities, used by Home Assistant dashboards and Home Assistant Cloud.

For Cloud-friendly camera viewing, publish the camera source in Toposync, then use the Toposync custom integration so Home Assistant creates native camera entities. Do not depend on direct WebRTC inside the Toposync ingress iframe as the remote viewing path.

See Camera entities and Cloud.

Next: Add your first camera.