En las versiones actuales de ZimaOS, no sigas instrucciones de Ubuntu que instalan NVIDIA Container Toolkit en el host con apt. ZimaOS tiene su propia integración de controlador/entorno de ejecución de NVIDIA, y la documentación actual sobre aplicaciones de Docker muestra que los contenedores con GPU usan runtime: nvidia junto con NVIDIA_VISIBLE_DEVICES.
El usuario de la fuente de 2025 tenía un servidor x86 genérico con una GTX 1050 y se dio cuenta correctamente de que ZimaOS no tiene un gestor de paquetes Debian normal. Ejecutar el kit de herramientas dentro de un contenedor Alpine tampoco puede resolver el problema del entorno de ejecución del host: el entorno de ejecución de NVIDIA debe existir en la capa del host de Docker.
Primero, verifica el controlador de la GPU del host
nvidia-smi
lspci -nnk | grep -A3 -Ei 'vga|3d|display'Si nvidia-smi no puede comunicarse con la GPU, la configuración de Docker no es el primer problema que debes revisar.
Comprueba si Docker ya tiene el entorno de ejecución de NVIDIA
docker info | grep -i nvidia
ps aux | grep '[d]ockerd'Actualmente, ZimaOS suele iniciar Docker con el entorno de ejecución de NVIDIA disponible, incluso en sistemas donde no se utiliza activamente.
Usa el modelo de entorno de ejecución de ZimaOS
La guía actual del entorno de ejecución de NVIDIA para Docker en ZimaOS muestra:
services:
my-gpu-app:
image: your/image
runtime: nvidia
ipc: host
environment:
NVIDIA_VISIBLE_DEVICES: allPor qué no funciona instalar el kit de herramientas en otro contenedor
NVIDIA Container Toolkit se integra con Docker/containerd en el host. La guía de instalación de NVIDIA Container Toolkit de NVIDIA usa nvidia-ctk runtime configure para modificar la configuración de Docker en el host y reiniciar Docker.
No copies instrucciones de apt en ZimaOS
La guía de instalación de NVIDIA presupone distribuciones compatibles de tipo Debian/RPM con gestores de paquetes en el host. ZimaOS actualmente no se mantiene de esa manera, por lo que las instrucciones para instalar paquetes en el host pueden entrar en conflicto con la imagen del dispositivo y el modelo de actualizaciones.
Probar el acceso a la GPU en un contenedor
Una vez que el controlador del host y el entorno de ejecución funcionen correctamente, usa un contenedor que admita GPU o tu aplicación de destino para confirmar que el dispositivo sea realmente visible dentro del contenedor.
La GTX 1050 tiene limitaciones según la carga de trabajo
Una GTX 1050 puede ser suficiente para algunas tareas de transcodificación con NVENC/NVDEC, pero las cargas de trabajo de IA, como el aprendizaje automático actual de Immich, pueden tener requisitos más estrictos de CUDA, VRAM, modelo y framework. Que «Docker detecte la GPU» no garantiza que todas las aplicaciones sean compatibles.
Haz una copia de seguridad de la configuración de la aplicación antes de cambiar los ajustes del entorno de ejecución
No sustituyas manualmente los archivos de servicio de Docker ni la configuración del entorno de ejecución, a menos que puedas revertir los cambios. Una configuración incorrecta del entorno de ejecución del host puede impedir que funcionen todas las aplicaciones de Docker, no solo el contenedor con GPU.
La guía actual de contenedores con GPU ofrece una explicación más completa de las diferencias entre el software actual y el antiguo.
Comprueba el entorno de ejecución dentro de la aplicación de destino
Que nvidia-smi funcione en el host solo demuestra que el controlador del host de ZimaOS detecta la tarjeta. Abre una shell en el contenedor habilitado para GPU y verifica allí el dispositivo y el entorno de ejecución; de lo contrario, una aplicación puede pasar a usar la CPU sin avisar, aunque la GPU del host parezca funcionar correctamente.
Distingue entre transcodificación y compatibilidad con IA
La compatibilidad con NVENC/NVDEC, la capacidad de cálculo de CUDA, la VRAM y los frameworks específicos de cada aplicación son limitaciones distintas. Una tarjeta que pueda gestionar la transcodificación de Plex/Jellyfin quizá sea demasiado antigua o tenga muy poca capacidad para un modelo de aprendizaje automático actual.
Preguntas frecuentes
¿Debería instalar nvidia-container-toolkit con apt en ZimaOS?
No. Usa el método actual del entorno de ejecución de NVIDIA en ZimaOS en lugar de tratar el host como si fuera Ubuntu.
¿Puedo instalar el kit de herramientas dentro de Docker con Alpine?
No. La integración del entorno de ejecución debe estar disponible en el host de Docker.
¿Cómo sé si Docker detecta NVIDIA?
Comprueba docker info, el comando o entorno de ejecución del daemon de Docker y, después, verifica el acceso a la GPU dentro del contenedor de destino.
¿Que nvidia-smi del host funcione demuestra que funcionará el aprendizaje automático de Immich?
No. Demuestra que el controlador del host detecta la tarjeta; el contenedor y la aplicación siguen necesitando compatibilidad con CUDA/VRAM/entorno de ejecución.
