Installation on Linux
Installation of Celantur Container on Linux
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
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 a time-limited password (provided by Celantur via email) to download the image from the Celantur Container Registry.
Download the Container
Download celantur.sh script.
Assign the password to a variable:
export PASSWD=.......
Optional: Set
export VERSION=...
for a specific version. Default islatest
. You can find version numbers in the Release Notes.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)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 filelicense
into this folder aslicensing/license
.
Run the Container
Copy some images into the
input
directory.Run
bash celantur.sh -a person -a vehicle
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:
Last updated