Additional findface-video-worker Deployment on Remote Hosts


Before deploying findface-video-worker instances on remote hosts, do the following:

  1. Allow accessing the findface-ntls license server from any IP address. To do so, open the /etc/findface-ntls.cfg configuration file on the server with findface-ntls and set listen = Restart the findface-ntls service.

    sudo vi /etc/findface-ntls.cfg
    ## Address to accept incoming client connections (IP:PORT)
    ## type:string env:CFG_LISTEN longopt:--listen
    listen =
    sudo systemctl restart findface-ntls.service
  2. Allow accessing the findface-video-manager service from any IP address. To do so, open the /etc/findface-video-manager.conf configuration file on the server with findface-video-manager and set listen: and rpc:listen: Restart the findface-video-manager service.

    sudo vi /etc/findface-video-manager.conf
    sudo systemctl restart findface-video-manager.service
  3. On the FindFace server, open the /etc/findface-security/ configuration file and make sure that the ROUTER_URL parameter contains the external IP address of the FindFace server and not the localhost. The findface-video-worker instances on the remote hosts will be using this address for posting objects.

    sudo vi /etc/findface-security/
    'ROUTER_URL': '',

To install only a findface-video-worker service, do the following:


Before deployment, be sure to consult the system requirements.


If you have several video cards on your server, see Multiple Video Cards Usage before deploying findface-video-worker-gpu.

  1. Download the installer file findface-*.run.

  2. Put the .run file into some directory on the designated host (for example, /home/username).

  3. From this directory, make the .run file executable.


    Be sure to specify the actual file name instead of findface-*.

    chmod +x findface-*.run
  4. Execute the .run file.

    sudo ./findface-*.run

    The installer will ask you a few questions and perform several automated checks to ensure that the host meets the system requirements. After filling out each prompt, press Enter. The questions and answers are the following:

    1. Product to install: FindFace Video Worker.

    2. Type of findface-video-worker package: CPU or GPU.

    3. IP address of the findface-security host.

    After that, the installation process will automatically begin.


If you chose to install findface-ntls and/or findface-video-manager on different hosts than that with findface-security, specify their IP addresses in the /etc/findface-video-worker-cpu.ini (/etc/findface-video-worker-gpu.ini) configuration file after the installation.

sudo vi /etc/findface-video-worker-cpu.ini
sudo vi /etc/findface-video-worker-gpu.ini

In the ntls-addr parameter, specify the findface-ntls host IP address.


In the mgr-static parameter, specify the findface-video-manager host IP address, which provides findface-video-worker with settings and the video stream list.



To automatically install findface-video-worker on another host without answering the installation questions, use the /tmp/<findface-installer-*>.json file. Execute:

sudo ./<findface-*>.run -f /tmp/<findface-installer-*>.json

You can find an example of the installation file in Installation File.


To preserve the FindFace compatibility with the installation environment, we highly recommend you to disable the Ubuntu automatic update. In this case, you will be able to update your OS manually, fully controlling which packages to update.

To disable the Ubuntu automatic update, execute the following commands:

sudo apt-get remove unattended-upgrades
sudo systemctl stop apt-daily.timer
sudo systemctl disable apt-daily.timer
sudo systemctl disable apt-daily.service
sudo systemctl daemon-reload


The FindFace services log a large amount of data, which can eventually lead to disc overload. To prevent this from happening, we advise you to disable rsyslog due to its suboptimal log rotation scheme and use the appropriately configured systemd-journal service instead. See Service Logs for the step-by-step instructions.