Host Linux: Installare il driver NVIDIA e Docker ≥ 23, aggiungere l' utente al gruppo docker (quindi effettuare nuovamente l'accesso), installare il NVIDIA Container Toolkit e configurare il runtime di Docker.

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

Su Windows, il container viene eseguito in una macchina virtuale Linux con WSL 2 (Windows 10 21H2 o versioni successive). Importante: il driver NVIDIA viene installato solo su Windows – mai all’interno di WSL; la GPU viene automaticamente passata.

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

Attivare in Docker Desktop il motore WSL-2 e l’integrazione WSL della distribuzione; in questo modo non è necessario un Container Toolkit. Senza Docker Desktop, installi Docker Engine nella distribuzione, aggiunga l’ utente al gruppo docker, attivi systemd in /etc/wsl.conf; se il servizio non si avvia, riavvii WSL e installi il NVIDIA Container Toolkit.

Verifica comune per tutti e tre i percorsi: questo comando deve visualizzare la scheda grafica . Se fallisce, qualsiasi ulteriore configurazione è inutile:

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