Hôte Linux : Installez le pilote NVIDIA et Docker ≥ 23, ajoutez l' utilisateur au groupe docker (puis reconnectez-vous), installez le NVIDIA Container Toolkit et configurez le runtime Docker.

sudo usermod -aG docker "$USER"
sudo nvidia-ctk runtime configure --runtime=docker
sudo systemctl restart docker

Sous Windows, le conteneur s'exécute dans une machine virtuelle Linux sous WSL 2 (Windows 10 21H2 ou version ultérieure). Important : le pilote NVIDIA est installé uniquement sous Windows – jamais au sein de WSL ; le GPU est automatiquement transféré.

wsl --install -d Ubuntu-22.04
wsl --update

Activez dans Docker Desktop le moteur WSL 2 et l'intégration WSL de la distribution ; un Container Toolkit n'est alors pas nécessaire. Sans Docker Desktop, installez Docker Engine dans la distribution, ajoutez l' utilisateur au groupe docker, activez systemd dans /etc/wsl.conf ; si le service ne démarre pas, redémarrez WSL et installez le NVIDIA Container Toolkit.

Test commun pour les trois méthodes – cette commande doit afficher la carte graphique . Si elle échoue, toute configuration supplémentaire est inutile :

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