Installation on Linux

Installation of Celantur Container on Linux

Setup Support 🤝

We are happy to help you with setting up Celantur Container. Please contact your sales representative.

Prerequisites

Check installed prerequisites

You can check whether dependencies are already installed:

• Docker: docker version

• NVIDIA driver: nvidia-smi

• NVIDIA Docker runtime: nvidia-container-runtime --version

If any of the above commands returns an error, proceed with the next section or parts of it.

Set up host machine

Install Docker

Install Docker

curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh

Add your user to the docker group. It takes effect with the next login.

sudo groupadd docker
sudo usermod -aG docker $USER

If you don't add your user to the docker group, you'll receive the following error when running the docker command:

Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Get http:///var%2Frun%2Fdocker.sock/v1.40/containers/json: dial unix /var/run/docker.sock: connect: permission denied

Install NVIDIA driver

Install NVIDIA driver with sudo apt install nvidia-driver-515

Install Nvidia Container Runtime

Install nvidia-container-runtime: Required to access the GPUs within the Docker containers.

curl -s -L https://nvidia.github.io/nvidia-container-runtime/gpgkey | \
  sudo apt-key add -
distribution=$(. /etc/os-release;echo $ID$VERSION_ID)
curl -s -L https://nvidia.github.io/nvidia-container-runtime/$distribution/nvidia-container-runtime.list | \
  sudo tee /etc/apt/sources.list.d/nvidia-container-runtime.list

sudo apt-get update
sudo apt-get install -y nvidia-container-runtime
sudo systemctl restart docker

Test the setup

docker run --gpus all nvidia/cuda:11.7.1-base-ubuntu22.04 nvidia-smi

Deploy Celantur Container

You'll receive an email from Celantur containing:

• The link to the celantur.sh bash script, which will help you with downloading the image from our Container Registry and running Celantur Container.

• A password to download Celantur Container (valid for 12 hours).

• A license file.

Steps:

1. Create a new directory (e.g. "Celantur").

2. Run wget <webserver-link-to-celantur.sh> in the newly created directory to download the bash script

3. Run export PASSWD=... to set the password for downloading Celantur Container as a temporary environment variable.

4. Run mkdir licensing and copy the license file into the licensing directory.

If your password expired, please let us know. We're happy to send you a new one.

Anonymize your first images

1. Run mkdir input

2. Copy some images into the input directory.

3. Run bash celantur.sh -a face -a license-plate --format pano:8000 (for panorama images).

4. Check the anonymized in the output directory.

Start to integrate Celantur Container into your workflow with the various data ingestion modes:

Batch and Stream mode

REST API mode

TCP mode