• OS: Ubuntu 18.04 or 20.04
  • HDD: 30Gb of free space
  • Internet connection
  • Root privileges
  • NVIDIA GPU with properly installed drivers

GPU drivers

BitRefine Heads requires following GPU hardware: NVIDIA GPU card with CUDA Compute Capability 3.5 or higher. Use official NVIDIA website to download and install drivers:


If your HW is based on NVidia Jetson, please ensure that you're using JetPack 4.4 OR JetPack 4.6. Other versions have different set of drivers and will not work.

Before proceeding, please, check if the drivers installed correctly.



BitRefine Heads platform uses Docker containers. If your machine has already an installed Docker engine, please contact BitRefine’s support before proceeding.

BitRefine HEADS Server installation file is head-{version}-{architecture}.sh, for example:

Copy it to your server and run with following command:

chmod +x head-*
sudo ./head-*

The installer script will download all required packages and prepare machine for running the video processing worker.

If Heads MANAGER runs on a different host, you need to specify IP-address (or domain) of the Manager's machine. Open config.ini file and change parameter: manager_host_address:

sudo nano /opt/bitrefine/heads_server/config/config.ini

After the changes are saved, you need to restart the Head's service:

sudo systemctl restart bitrefine_head

If the Manager's host is set correctly, the Head will connect the Manager automatically, and it will show up in the Servers menu. You can check status of the Head service directly:

systemctl status bitrefine_head