Skip to main content

Add Cameras

Cameras are managed by VPP — you register an RTSP stream there, VPP performs face detection and matching, and the resulting events flow into the Hub. If you have not chosen hardware yet, start with Cameras. CIGS and the Hub reference cameras by their VPP camera IDs; those IDs are what you list in the FOUNDATION_UNITS_0_CAMERAS setting of .env.hub.

Prerequisites​

  • The stack is running (see First Deployment)
  • An RTSP stream URL reachable from the VPP containers
  • The unit (corridor or e-gate) the camera belongs to, as defined by FOUNDATION_UNITS_0_ID in .env.hub

Register a camera in VPP​

Open the VPP Admin interface at http://localhost:8000 and add a camera with its RTSP stream URL, or use the VPP API. The exact API shape, authentication, and stream options are documented in the VPP platform documentation — Smart Corridors uses VPP unchanged for video processing, so its camera management applies directly.

Once a camera is registered, VPP connects to the stream immediately and begins emitting detections; no corridor service needs a restart.

Wire the camera into a unit​

Add the camera's VPP ID to the unit definition in .env.hub so the Hub attributes its events to the right corridor or e-gate:

FOUNDATION_UNITS_0_ID=corridor-1
FOUNDATION_UNITS_0_TYPE=CORRIDOR
FOUNDATION_UNITS_0_CAMERAS=<camera-id-1>,<camera-id-2>

Apply the change by restarting the Hub:

docker compose up -d hub

Verify​

Confirm detections are flowing by opening the corridor dashboard at http://localhost:8095, or query the Hub's GraphQL API at http://localhost:8090/corridor-foundation/graphql for recent identity and zone events on the unit.

Next step​

Add People to Watchlists — enroll subjects so the system can identify them against the camera streams.