Installation with Docker¶
Before, proceeding have a look at the Docker documentation and install Docker on your system.
Rady-to-use Images¶
You can pull the following images from the ufo-kit repository on dockerhub without the need of Building them. They contain the complete software stack including ufo-core, ufo-filters, tofu and their dependencies (except NVIDIA driver), so after the installation you can start using all the available tools, including GUIs:
docker pull tfarago/ufo-kit:ufo-nvidia-ubuntu-20.04
docker pull tfarago/ufo-kit:ufo-intel-ubuntu-20.04
Build¶
Depending on the GPUs in your system you have to use a different Dockerfile.
Before doing so, create an empty directory and copy the respective Dockerfile
from the docker
directory and rename it to Dockerfile
. In the case of
the AMD-based Dockerfile you have to download
AMD-APP-SDK-v3.0-0.113.50-Beta-linux64,
and move it into the same directory. Now go into the directory and type:
$ docker build -t ufo .
This will build an image tagged ufo
containing both ufo-core and
ufo-filters.
Usage on AMD¶
Run the image in a new Docker container using:
$ docker run -it --device=/dev/ati/card0 ufo
Usage on NVIDIA¶
Install nvidia-container-runtime and then pull the image:
$ docker pull tfarago/ufo-kit:ufo-nvidia-ubuntu-20.04
and run:
$ docker run --rm -it --gpus all tfarago/ufo-kit:ufo-nvidia-ubuntu-20.04
If you want to use the graphical user interfaces (GUIs) run:
$ sudo xhost +local:username
$ docker run --rm -it --gpus all -v /tmp/.X11-unix:/tmp/.X11-unix -e DISPLAY=$DISPLAY tfarago/ufo-kit:ufo-nvidia-ubuntu-20.04
Usage on Intel¶
First install the OpenCL runtime (Ubuntu-specific but it should be similar for other distributions):
$ sudo apt-get install intel-opencl-icd
then pull the image:
$ docker pull tfarago/ufo-kit:ufo-intel-ubuntu-20.04
and run the following:
$ docker run --rm -it --device /dev/dri:/dev/dri tfarago/ufo-kit:ufo-intel-ubuntu-20.04
or this for GUI support:
$ sudo xhost +local:username
$ docker run --rm -it --device /dev/dri:/dev/dri -v /tmp/.X11-unix:/tmp/.X11-unix -e DISPLAY=$DISPLAY tfarago/ufo-kit:ufo-intel-ubuntu-20.04