Sur la version actuelle de ZimaOS, ne suivez pas les instructions Ubuntu qui installent NVIDIA Container Toolkit avec apt sur l’hôte. ZimaOS dispose de sa propre intégration des pilotes et de l’environnement d’exécution NVIDIA, et sa documentation actuelle sur les applications Docker montre que les conteneurs GPU utilisent runtime: nvidia ainsi que NVIDIA_VISIBLE_DEVICES.
L’utilisateur de la source datant de 2025 disposait d’un serveur x86 générique équipé d’une GTX 1050 et a constaté à juste titre que ZimaOS n’avait pas de gestionnaire de paquets Debian classique. Exécuter le toolkit dans un conteneur Alpine ne peut pas non plus résoudre le problème de l’environnement d’exécution de l’hôte : l’environnement NVIDIA doit être disponible au niveau de l’hôte Docker.
Vérifiez d’abord le pilote GPU de l’hôte
nvidia-smi
lspci -nnk | grep -A3 -Ei 'vga|3d|display'Si nvidia-smi ne parvient pas à communiquer avec le GPU, la configuration de Docker n’est pas le premier problème à résoudre.
Vérifiez si Docker dispose déjà de l’environnement NVIDIA
docker info | grep -i nvidia
ps aux | grep '[d]ockerd'Les versions actuelles de ZimaOS démarrent généralement Docker avec l’environnement NVIDIA disponible, même sur les systèmes où il n’est pas activement utilisé.
Utilisez le modèle d’environnement d’exécution de ZimaOS
Le guide actuel de l’environnement Docker NVIDIA de ZimaOS présente l’exemple suivant :
services:
my-gpu-app:
image: your/image
runtime: nvidia
ipc: host
environment:
NVIDIA_VISIBLE_DEVICES: allPourquoi l’installation du toolkit dans un autre conteneur ne fonctionne pas
NVIDIA Container Toolkit s’intègre à Docker/containerd sur l’hôte. Le guide d’installation de NVIDIA Container Toolkit utilise nvidia-ctk runtime configure pour modifier la configuration Docker de l’hôte et redémarrer Docker.
Ne copiez pas les instructions apt dans ZimaOS
Le guide d’installation de NVIDIA suppose l’utilisation de distributions prises en charge de type Debian/RPM, avec un gestionnaire de paquets sur l’hôte. La version actuelle de ZimaOS n’est pas gérée de cette manière ; les instructions destinées à l’hôte peuvent donc entrer en conflit avec l’image de l’appliance et son modèle de mise à jour.
Testez l’accès au GPU dans un conteneur
Une fois le pilote et l’environnement d’exécution de l’hôte opérationnels, utilisez un conteneur compatible GPU connu ou votre application cible afin de confirmer que le périphérique est effectivement visible à l’intérieur du conteneur.
La GTX 1050 a des limites selon les charges de travail
Une GTX 1050 peut convenir à certains travaux de transcodage NVENC/NVDEC, mais les charges de travail d’IA, comme l’apprentissage automatique actuel d’Immich, peuvent imposer des exigences plus strictes en matière de CUDA, de mémoire vidéo, de modèles et de frameworks. Le fait que « Docker détecte le GPU » ne garantit pas que chaque application le prend en charge.
Sauvegardez la configuration des applications avant de modifier les paramètres d’exécution
Ne remplacez pas manuellement les fichiers de service Docker ou la configuration de l’environnement d’exécution sans possibilité de revenir en arrière. Une mauvaise configuration de l’environnement sur l’hôte peut arrêter toutes les applications Docker, et pas uniquement le conteneur GPU.
Le guide actuel des conteneurs GPU présente plus en détail la distinction entre les anciennes et les nouvelles limites logicielles.
Vérifiez l’environnement d’exécution dans l’application cible
La commande nvidia-smi exécutée sur l’hôte prouve seulement que le pilote de l’hôte ZimaOS détecte la carte. Ouvrez un shell dans le conteneur compatible GPU utilisé par l’application et vérifiez-y le périphérique et l’environnement d’exécution ; sinon, l’application peut silencieusement revenir au processeur alors que le GPU de l’hôte semble fonctionner correctement.
Distinguez le transcodage de la compatibilité avec l’IA
La prise en charge de NVENC/NVDEC, la capacité de calcul CUDA, la mémoire vidéo et les frameworks propres à chaque application sont des contraintes différentes. Une carte capable de gérer le transcodage Plex/Jellyfin peut néanmoins être trop ancienne ou disposer de trop peu de mémoire pour un modèle d’apprentissage automatique actuel.
FAQ
Dois-je installer nvidia-container-toolkit avec apt sur ZimaOS ?
Non. Utilisez l’environnement NVIDIA actuel de ZimaOS plutôt que de traiter l’hôte comme une machine Ubuntu.
Puis-je installer le toolkit dans Docker Alpine ?
Non. L’intégration de l’environnement d’exécution doit être disponible sur l’hôte Docker.
Comment savoir si Docker détecte NVIDIA ?
Vérifiez docker info, la commande du daemon Docker et son environnement d’exécution, puis vérifiez l’accès au GPU à l’intérieur du conteneur cible.
La commande nvidia-smi sur l’hôte prouve-t-elle qu’Immich ML fonctionnera ?
Non. Elle prouve que le pilote de l’hôte détecte le GPU ; le conteneur et l’application doivent également disposer d’une prise en charge compatible de CUDA, de la mémoire vidéo et de l’environnement d’exécution.
