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

By using the celantur.sh script and a time-limited password as well as the license file (provided by Celantur via email), download and run the latest image from the Celantur Container Registry.

Steps to deploy Celantur Container

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

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

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

4. Assign the password to a variable: export PASSWD=eyJ...4fQ==

5. Run bash celantur.sh to download the latest release.

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

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

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

1. Run mkdir input

2. Copy some images into the input directory.

3. Follow instructions at Anonymize Images and Videos.

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