Windows dependencies (WSL)

Don't follow this step if you plan to run BlurIt OP on Linux. Go there instead.

Prerequisites Before Installation

Before starting the installation, ensure you have received the archive containing all necessary documents. This archive will be shared via a secured link protected by a password.

Contents of the Archive

Main Archive: client_name_YYYYMMDD.tar.gz

The archive will include the following files:

1. License File: license_client_name_YYYYMMDD_YYYYMMDD

   • The license file specifies the validity period (start and end dates).

2. Registry Login: login_registry.txt

   • Contains the credentials to access the registry.

3. Custom Configuration File (if applicable): blurit_stack.yml

Nvidia Driver installation

Download the NVIDIA driver >= 470 exe from: https://www.nvidia.com/Download/index.aspx?lang=en-us

You can also update the drivers using Nvidia Geforce Experience.

Install WSL 2 (Windows Subsystem Linux)

To Check if WSL is installed, open PowerShell as administrator and run:

wsl -l –v

If WSL is not installed:

wsl --install -d Ubuntu

Then reboot your machine.

It is possible to modify the resources allocated to WSL. For more information, you can refer to this link: https://learn.microsoft.com/fr-fr/windows/wsl/wsl-config#wslconfig.

Docker installation

Instruction to install docker CE on windows with WSL 2 backend : https://docs.docker.com/desktop/install/windows-install/.

During the install don't forget to tick the Use WSL 2 instead of Hyper-V checkbox.

Additionally, if you want the BlurIt app to restart automatically when the machine restarts, check the box labeled 'Start Docker Desktop when you sign, in.'

Nvidia-docker installation

To enter WSL, open PowerShell and type wsl followed by pressing Enter.

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 nvidia-ctk runtime configure --runtime=docker

Verify that Nvidia-Docker is installed:

sudo docker run --rm --gpus all nvidia/cuda:11.6.2-base-ubuntu20.04 nvidia-smi -a

Configuring Docker daemon

Append the following JSON content on the Docker Desktop config like this:

{
	... # current content
	"runtimes": {
		"nvidia": {
			"path": "/usr/bin/nvidia-container-runtime",
			"runtimeArgs": []
		}
	},
	"default-runtime": "nvidia"
}

Restart Docker for the change to take effect.

Post-install docker linux on WSL (required):

sudo groupadd docker
sudo usermod -aG docker $USER
newgrp docker

Blurit CLI

The Blurit CLI enables you to easily configure, start, and interact with Blurit. It provides a command-line interface to manage features and streamline platform usage.

The blurit binary is provided in the archive you received: there is nothing to download and nothing to install. Extract the archive from WSL (not from the Windows Explorer, so that the file permissions are preserved) and run the CLI straight from that directory:

tar -xzf filename.tar.gz
cd blurit-op
chmod +x ./blurit
./blurit version

Replace "filename" with the actual name of the archive that was provided to you.

If you prefer to call it as blurit instead of ./blurit, move it to a directory of your PATH:

sudo mv blurit /usr/local/sbin

If running ./blurit reports Permission denied, the executable bit was lost while copying the archive around: restore it with chmod +x blurit.

The blurit requirements command described on the Linux dependencies page is meant for native Linux servers: it installs Docker Engine and the NVIDIA driver itself. On WSL, Docker is provided by Docker Desktop and the NVIDIA driver is installed on Windows, so follow the manual steps of this page instead.

You can now continue with Install Blurit OP.