> For the complete documentation index, see [llms.txt](https://doc-op.blurit.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc-op.blurit.io/2.15.0/blurit-on-premise/installation/windows-dependencies-wsl.md).

# Windows dependencies (WSL)

*Don't follow this step if you plan to run BlurIt OP on Linux.* [*Go there*](/2.15.0/blurit-on-premise/installation/linux-dependencies.md) *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](https://www.nvidia.com/fr-fr/geforce/geforce-experience/).

## Install WSL 2 (Windows Subsystem Linux)

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

{% code lineNumbers="true" %}

```powershell
wsl -l –v
```

{% endcode %}

If WSL is not installed:

{% code lineNumbers="true" %}

```
wsl --install -d Ubuntu
```

{% endcode %}

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.'

<figure><img src="https://content.gitbook.com/content/cRuVBwKJviaiQQZy6xLi/blobs/P1OgbovyIqYR0foNPWC2/docker-config.PNG" alt=""><figcaption></figcaption></figure>

## Nvidia-docker installation

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

{% code lineNumbers="true" %}

```bash
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
```

{% endcode %}

Verify that Nvidia-Docker is installed:

{% code lineNumbers="true" %}

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

{% endcode %}

### Configuring Docker daemon

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

{% code lineNumbers="true" %}

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

{% endcode %}

<figure><img src="https://content.gitbook.com/content/cRuVBwKJviaiQQZy6xLi/blobs/oy5tkAF8voXVnUapRoTF/Windows_daemon-docker.png" alt=""><figcaption></figcaption></figure>

Restart Docker for the change to take effect.

### Post-install docker linux on WSL (required):

{% code lineNumbers="true" %}

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

{% endcode %}

## 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:

{% code lineNumbers="true" %}

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

{% endcode %}

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`:

```bash
sudo mv blurit /usr/local/sbin
```

{% hint style="info" %}
If running `./blurit` reports `Permission denied`, the executable bit was lost while copying the archive around: restore it with `chmod +x blurit`.
{% endhint %}

{% hint style="warning" %}
The `blurit requirements` command described on the [Linux dependencies](/2.15.0/blurit-on-premise/installation/linux-dependencies.md) 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.
{% endhint %}

You can now continue with [Install Blurit OP](/2.15.0/blurit-on-premise/installation/install-blurit-op.md).
