Unter dem aktuellen ZimaOS sollten Sie keine Ubuntu-Anleitungen befolgen, die das NVIDIA Container Toolkit mit apt auf dem Host installieren. ZimaOS verfügt über eine eigene Integration für NVIDIA-Treiber und -Laufzeitumgebungen. Die aktuelle Dokumentation für Docker-Apps zeigt GPU-Container mit runtime: nvidia und NVIDIA_VISIBLE_DEVICES.
Der Nutzer der Quelle aus dem Jahr 2025 hatte einen gewöhnlichen x86-Server mit einer GTX 1050 und stellte richtigerweise fest, dass ZimaOS keinen normalen Debian-Paketmanager besitzt. Die Installation des Toolkits in einem Alpine-Container kann das Laufzeitproblem auf dem Host ebenfalls nicht lösen – die NVIDIA-Laufzeitumgebung muss auf der Docker-Host-Ebene vorhanden sein.
Zuerst den GPU-Treiber des Hosts überprüfen
nvidia-smi
lspci -nnk | grep -A3 -Ei 'vga|3d|display'Wenn nvidia-smi keine Verbindung zur GPU herstellen kann, liegt das erste Problem nicht bei der Docker-Konfiguration.
Prüfen, ob Docker bereits über die NVIDIA-Laufzeitumgebung verfügt
docker info | grep -i nvidia
ps aux | grep '[d]ockerd'Bei aktuellem ZimaOS wird Docker häufig mit verfügbarer NVIDIA-Laufzeitumgebung gestartet, auch auf Systemen, auf denen sie nicht aktiv verwendet wird.
Das ZimaOS-Laufzeitmodell verwenden
Die aktuelle Anleitung zur NVIDIA-Docker-Laufzeitumgebung von ZimaOS zeigt:
services:
my-gpu-app:
image: your/image
runtime: nvidia
ipc: host
environment:
NVIDIA_VISIBLE_DEVICES: allWarum die Installation des Toolkits in einem anderen Container nicht funktioniert
Das NVIDIA Container Toolkit integriert sich auf dem Host in Docker bzw. containerd. Die offizielle Installationsanleitung für das NVIDIA Container Toolkit verwendet nvidia-ctk runtime configure, um die Docker-Konfiguration des Hosts zu ändern und Docker neu zu starten.
Keine apt-Anleitungen in ZimaOS übernehmen
Die Installationsanleitung von NVIDIA setzt unterstützte Debian-/RPM-basierte Distributionen mit Paketmanagern auf dem Host voraus. Das aktuelle ZimaOS wird nicht auf diese Weise verwaltet. Daher können Paketinstallationsanweisungen für den Host mit dem Appliance-Image und dem Aktualisierungsmodell in Konflikt geraten.
GPU-Zugriff in einem Container testen
Sobald der Host-Treiber und die Laufzeitumgebung ordnungsgemäß funktionieren, verwenden Sie einen bekannten GPU-fähigen Container oder Ihre Ziel-App, um zu bestätigen, dass das Gerät im Container tatsächlich sichtbar ist.
Die GTX 1050 hat Einschränkungen bei der Arbeitslast
Eine GTX 1050 kann für bestimmte NVENC-/NVDEC-Transkodierungsaufgaben ausreichen. KI-Arbeitslasten wie das aktuelle Machine Learning von Immich können jedoch strengere Anforderungen an CUDA, VRAM, Modelle und Frameworks stellen. „Docker erkennt die GPU“ bedeutet nicht automatisch, dass jede App sie unterstützt.
App-Konfiguration sichern, bevor Laufzeiteinstellungen geändert werden
Ersetzen Sie Docker-Dienstdateien oder die Laufzeitkonfiguration nicht manuell, sofern Sie die Änderungen nicht rückgängig machen können. Eine fehlerhafte Laufzeitkonfiguration auf dem Host kann alle Docker-Apps stoppen, nicht nur den GPU-Container.
Die aktuelle Anleitung für GPU-Container bietet eine ausführlichere Gegenüberstellung der heutigen und früheren Softwaregrenzen.
Die Laufzeitumgebung in der Ziel-App überprüfen
nvidia-smi auf dem Host bestätigt lediglich, dass der ZimaOS-Hosttreiber die Karte erkennt. Öffnen Sie eine Shell im tatsächlich GPU-fähigen Container und überprüfen Sie dort Gerät und Laufzeitumgebung. Andernfalls kann eine App stillschweigend auf die CPU zurückfallen, während die Host-GPU ordnungsgemäß funktioniert.
Transkodierung und KI-Kompatibilität getrennt betrachten
NVENC-/NVDEC-Unterstützung, CUDA-Rechenfähigkeit, VRAM und anwendungsspezifische Frameworks sind unterschiedliche Einschränkungen. Eine Karte, die Transkodierung mit Plex oder Jellyfin bewältigt, kann für ein aktuelles ML-Modell dennoch zu alt oder zu leistungsschwach sein.
FAQ
Soll ich nvidia-container-toolkit per apt auf ZimaOS installieren?
Nein. Verwenden Sie den aktuellen NVIDIA-Laufzeitpfad von ZimaOS, anstatt den Host wie Ubuntu zu behandeln.
Kann ich das Toolkit in Alpine Docker installieren?
Nein. Die Laufzeitintegration muss auf dem Docker-Host vorhanden sein.
Wie erkenne ich, ob Docker NVIDIA erkennt?
Prüfen Sie docker info, den Befehl bzw. die Laufzeitumgebung des Docker-Daemons und anschließend den GPU-Zugriff im Zielcontainer.
Beweist nvidia-smi auf dem Host, dass Immich ML funktionieren wird?
Nein. Es bestätigt, dass der Treiber auf dem Host sichtbar ist. Der Container und die Anwendung benötigen weiterhin kompatible CUDA-, VRAM- und Laufzeitunterstützung.
