.. _video-allocation:

Allocate ``findface-video-worker`` to Camera Group
======================================================

In a distributed architecture, it is often necessary that video streams from a group of cameras be processed *in situ*, without being redistributed across remote ``findface-video-worker`` instances by the principal server. 

.. note:: 
   Among typical use cases are hotel chains, chain stores, several security checkpoints in the same building, etc. 

In this case, allocate the local ``findface-video-worker`` to the camera group.

Do the following:

#. Navigate to the :guilabel:`Settings` tab. Click :guilabel:`Camera Groups`.
#. Open the camera group settings.
#. In the :guilabel:`Labels`, create or select one or several allocation labels. Save changes.
#. Open the ``/opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml`` configuration file and specify the allocation labels in the dictionary format (labels ``MyLabel1``, ``MyLabel2`` in the example below).

   .. code::

      sudo vi /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml
      
      labels: {"MyLabel1": "true", "MyLabel2": "true"}

#. Restart the ``findface-multi-findface-video-worker-1`` container.

   .. code::

      sudo docker container restart findface-multi-findface-video-worker-1

.. note::
   If a camera is assigned an allocation label, its video stream can be processed by a ``findface-video-worker`` instance with the same label, as well as by all unlabeled ``findface-video-worker`` instances.

.. warning::
   If a labeled camera is processed by an unlabeled ``findface-video-worker`` instance and a free similar-labeled instance appears, the camera won’t automatically switch to the latter. Restart the similar-labeled camera.