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-580 (or a different version compatible with your GPU).

Install Nvidia Container Runtime

Install NVIDIA Container Toolkit: Required to access the GPUs within the Docker containers.

curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg \
curl -s -L https://nvidia.github.io/libnvidia-container/stable/deb/nvidia-container-toolkit.list | \
    sed 's#deb https://#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://#g' | \
    sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list
sudo apt-get update
sudo apt-get install -y nvidia-container-toolkit

sudo systemctl restart docker

Test the setup

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

Deploy Celantur Container

You'll receive a time-limited password (provided by Celantur via email) to download the image from the Celantur Container Registry.

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

Download the Container

1. Download celantur.sh script.

2. Assign the password to a variable: export PASSWD=.......

3. Optional: Set export VERSION=... for a specific version. Default is latest. You can find version numbers in the Release Notes.

4. Run bash celantur.sh --update to download the latest release.

Preparation

You need a license file (provided by Celantur) to run Celantur Container.

The following folders and file are necessary:

Celantur (root folder)
├── input/
├── licensing/
├── log/
├── output/
└── celantur.sh

• input: Where the original files are stored (including subfolders)

  • See Installation on Linux

  • See Installation on Linux

• output: Folder for the anonymized images/videos. If a file exists with the same as in input folder, then processing of the file is skipped.

• log: Folder containing the logs.

• licensing: Folder containing the license key. Copy the license file license into this folder as licensing/license.

Run the Container

1. Copy some images into the input directory.

2. Run bash celantur.sh -a person -a vehicle

3. Check the anonymized in the output directory.

Ensure that /tmp folder within the Container is read-writeable

If you run the Container with --read-only flag or use readonly filesystem in Kubernetes, you need to ensure that the /tmp folder within the Container can be both read and written with ca. 2 GiB space.

Anonymize your first images

Follow instructions at Anonymize Images and Videos.

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

Batch and Stream mode

REST API mode

TCP mode