Windows WSL
Everything you need to know about deploying Supervisely agent on Windows WSL
Deploy Supervisely agent with GPU on Windows WSL
This tutorial explains how to deploy the Supervisely agent with GPU support on Windows Subsystem for Linux (WSL). Whether you prefer following a video tutorial or a text-based guide, we've got you covered. In this guide, we'll walk you through the process step by step.
If you're a visual learner and prefer to watch along, check out our comprehensive video guide on deploying the Supervisely agent with GPU on Windows WSL. This guide will take you through each step visually, making it easier to follow along and set up the environment correctly.
Machine Specs used in video guide:
Operating System: Microsoft Windows 10 Enterprise (10.0.19045 Build 19045)
GPU: NVIDIA GeForce RTX 4090
GPU Driver Version: 536.67
UBUNTU: 22.04.2 LTS
Docker Desktop Version: 4.20.1 (110738)
If you prefer written instructions and a more detailed breakdown, here's how you can deploy the Supervisely agent with GPU on Windows WSL:
Machine Specs used in text guide:
Operating System: Microsoft Windows 11 Pro (10.0.22621 Build 22621)
GPU: NVIDIA GeForce RTX 3080 Ti (Laptop)
GPU Driver Version: 536.67
UBUNTU: 22.04.2 LTS
Docker Desktop Version: 4.1.1 (69879)
Table of Contents
Prerequisites
Windows 10 Home, Pro or Enterprise (64-bit edition). Version 1903 or higher, with Build 18362 or higher.
or
Windows 11 Home, Pro or Enterprise (64-bit edition).
and
Windows Terminal installed.
Ubuntu 22.04.2 installed.
WSL 2 installed and running.
NVIDIA GPU Driver installed.
Docker Desktop installed and running.
How to install
Step 1. Turn on WSL
Use windows search to find "Turn Windows features on or off" and open it.
Scroll down and locate "Windows Subsystem for Linux", check the box and restart your computer. If the box is already checked proceed to the next step.
Step 2. Install Windows Terminal
Open Microsoft Store and find Windows Terminal and press Get.
Step 3. Install Ubuntu
Open Microsoft Store and find Ubuntu 22.04.2 and press Get.
Step 4. Install NVIDIA GPU Driver
Go to NVIDIA site and download the latest driver for your GPU.
Fill the form and press Search.
Press Download button and install the driver.
Step 5. Docker Desktop
Download Docker Desktop and install it.
If you have problems running Docker Desktop, check out the possible problems when running Docker Desktop just below.
Open Docker Desktop and go to Settings -> Resources -> WSL integration. Check "Enable integration with my default WSL distro" and "Ubuntu 22.04" and press Apply & Restart as shown below.
Open Docker Desktop and go to Settings -> Docker engine and add runtime to the docker config file as shown below and press Apply & Restart:
Or you can copy and paste merged config file from here:
Step 6. Install NVIDIA Container Toolkit
Open Ubuntu terminal via Windows terminal
Install NVIDIA Container Toolkit repository for your distribution by running the following command:
Update the APT repository cache and install the nvidia-container-toolkit
package:
Restart Docker Desktop.
Enter the following command to verify that the installation was successful:
If you have problems running this container, try upgrading CUDA Toolkit to latest version.
After docker image is pulled, you will see nvidia-smi output.
Step 7. Deploy Supervisely Agent
Deploy Supervisely Agent with GPU support on Windows WSL.
Open Supervisely instance and go to the Start -> Team Cluster page and press "Add" button
Select "Supervisely agent".
Copy instructions bash
command in the modal window. System will automatically recognize and add available GPU to the agent.
Copy the instructions command and run it in the Ubuntu terminal.
After the agent docker image is pulled you will see this message in the terminal. It means that agent is successfully deployed.
Go to the Team Cluster page and open your agent, check that agent is running. That's it! Now you can run GPU tasks on your Windows machine.
Last updated