WSL Setup Guide

This page contains instructions on how to setup Windows Subsytem for Linux (WSL) for deploying or trying out the Audio2Face-3D Authoring Microservice. Run all the steps inside the WSL terminal unless mentioned otherwise.

Prerequisites

This documentation assumes the following system requirements:

WSL	v2 and Ubuntu 22.04
Windows Nvidia Driver	560.94
CUDA	12.6

Setup Docker without Docker Desktop

Install docker using the convenience script:

$ curl -fsSL https://get.docker.com get-docker.sh
$ sudo sh ./get-docker.sh

Add your user account to docker group:

$ sudo groupadd docker
$ sudo usermod -aG docker <username>

Logout and login again of your system, then do a sanity check:

$ docker run hello-world

You should see “Hello from Docker!” printed out.

Install the Docker Compose plugin:

$ sudo apt-get update
$ sudo apt-get install docker-compose-plugin

Check that the installation was successfull by running:

$ docker compose version

Set up iptables compatibility:

$ sudo update-alternatives --config iptables

When prompted, choose Selection 1, with the path /usr/sbin/iptables-legacy.

Shutdown the WSL instance by either closing the terminal window or typing in Powershell:

$ wsl --shutdown Ubuntu-22.04

Start a WSL instance and check Docker status:

$ service docker status

You should see “active (running)” in the messages. To exit, press q.

Install CUDA Toolkit

Once a Windows Nvidia driver is installed on the system, CUDA becomes available within WSL2. Therefore, users must not install any Nvidia Linux driver within WSL 2.

To download and install the CUDA Toolkit, visit Nvidia Developer - Cuda downloads, and follow the instructions for deb(local). Make sure you select the right architecture type for your system.

Install NVIDIA Container Toolkit

For installation follow the NVIDIA Container Toolkit docs

Then configure docker:

$ sudo nvidia-ctk runtime configure --runtime=docker
$ sudo systemctl restart docker

If all goes well then you should be able to start a Docker container and run nvidia-smi inside.

$ sudo docker run --rm --gpus all ubuntu nvidia-smi

Install NGC CLI

Download the right NGC CLI for Linux and your system architecture, and follow the install instructions.

We recommend going back to the Quick Start to start using the Audio2Face-3D Authoring Microservice inside WSL.