Installation on Windows

Support for Windows 10 is experimental, due to limited CUDA/GPU support.

Setup Support 🤝

We are happy to help you with setting up Celantur Container. Please contact your sales representative.

It is possible to run Celantur Container on Windows with WSL (Windows Subsystem for Linux). NVIDIA provides an official documentation to set up the software dependencies.

Please make sure your system fulfills the requirements:

Requirements

Alternatively, you can install Windows and Ubuntu on a separate partition on the same machine:

1. Create a bootable USB or bootable DVD

2. Follow the official step-by-step installation tutorial

Steps

1. Install Nvidia driver

Install the newest version of Nvidia Driver for your GPU.

2. Install Windows Subsystem for Linux

Install Windows Subsystem for Linux (WSL 2) with wsl --install -d Ubuntu.

If you receive following error Wsl/InstallDistro/Service/RegisterDistro/CreateVm/HCS/HCS_E_SERVICE_NOT_AVAILABLE, you need to enable virtualisation in command line with:

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
dism.exe /online /enable-feature /featurename:Microsoft-Hyper-V-All /all /norestart

On Windows 10, you might need to update the Linux kernel.

Check that you can access the NVIDIA driver from within WSL 2 by opening WSL and entering nvidia-smi. You should see detailled information about the GPU.

3. Install Docker Desktop

Install Docker Desktop on Windows.

Activate Docker WSL 2 integration, by checking "Use WSL 2 based engine" in the settings.

Activate Docker WSL 2 integration, by checking "Use WSL 2 based engine" in the settings.

4. Install Nvidia Container Runtime

Install NVIDIA Container Toolkit within WSL. (Start WSL with wsl)

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

5. Restart Docker

Click "Restart Docker..." in the context menu of the Docker icon in your taskbar's notification area.

6. Test CUDA container

Test that the setup is correct by running:

docker run --rm --gpus all nvidia/cuda:12.8.1-base-ubuntu22.04 nvidia-smi

Deploy Celantur Container

Please refer to Deploy Celantur Container in our Linux section. The Windows deployment process is the same for Linux.

Troubleshooting: CUDA is not available.

If you receive "ERROR: CUDA ist not available!", upgrading the Docker engine might resolve it.