Preparing your environment

Follow the installation requirements for running a Daemon on your machine

1/ BIOS settings

First, we want to ensure that our machine can run Virtualization containers, such as Docker. This is setup in the BIOS, and you will only have to do it once.

How to setup Virtualization in the BIOS

2/ Ubuntu install

If you have a windows machine, and want to make use of your GPU processing power for using AIs, there are a few pre-requirements to achieve, since NVIDIA has only made their GPU available via Virtualization (Docker) on Linux, and not on Windows.

Your Daemon can run on as many machines as you like. On each such machine, it requires a Linux/Ubuntu configuration.

Windows 10 and 11 can run good Linux compatible machines, so we will use this capability.

Your main goal is to install wsl2 on your Windows machine (wsl --install), then install a Ubuntu 22.04 instance (wsl --install -d Ubuntu-22.04), and finally, install Docker on this wsl session.

Follow the steps to install a wsl2 in the documentation below

How to install WSL on windows

1.3/ Docker install

We will then need to install Docker. It is preferred to install Docker via the windows Application "Docker Desktop", and activate the Ubuntu config from there. In case you would like to setup docker directly in Ubuntu, here is a good link to do this:

How to install Docker on Ubuntu

To check that your docker and wsl config are setup properly, open a Terminal, do this:

1/ type "wsl" [ENTER]

2/ check that your Terminal is now operating in a Linux subsystem

3/ type "docker ps" [ENTER]

4/ check that the docker command was understood (It will show a header as per the image below).

result after running a "docker ps" command

If you do not have this and docker is still not properly installed, it is very recommended to review the Windows "Docker Desktop" settings, and set it up from there. For this, run "Docker Desktop", and go into Settings > Resources. Here, make sure to force the toggle "Enable integration with additional distros" to ON, then relaunch Docker Desktop, and relaunch a wsl session.

Docker config for WSL

1.4/ Installing NVIDIA CUDA

You will need CUDA installed on your machine. Check the latest package on the following link.

NVIDIA CUDA

1.5/ Checking the config

A very good way to test if the whole installation was successful is to run the following command inside a wsl terminal.

This will validate the following:

When successfully running this command, the output will be as per below. As you can see the GPU (here a RTX 3090) was detected and accessible.

In case of problem during the setup, you can check all steps again one by one. There is also this alternative step by step guide, however it is slightly more technical to follow.

A step by step guide to access GPU within Docker on WSL Ubuntu within Windows

With Wsl, Ubuntu, Docker, and Cuda setup complete, we are ready to install an OSAIS Daemon.

Last updated