현재 ZimaOS에서는 호스트에 apt로 NVIDIA Container Toolkit을 설치하는 Ubuntu 지침을 따르지 마세요. ZimaOS에는 자체 NVIDIA 드라이버/런타임 통합 기능이 있으며, 현재 Docker 앱 문서에서는 GPU 컨테이너에 runtime: nvidia와 NVIDIA_VISIBLE_DEVICES를 함께 사용하도록 안내합니다.
2025년 원문의 사용자는 GTX 1050을 장착한 일반 x86 서버를 사용했고, ZimaOS에 일반적인 Debian 패키지 관리자가 없다는 점을 정확히 파악했습니다. Alpine 컨테이너 안에서 Toolkit을 실행해도 호스트 런타임 문제는 해결되지 않습니다. NVIDIA 런타임은 Docker 호스트 계층에 있어야 합니다.
먼저 호스트 GPU 드라이버 확인
nvidia-smi
lspci -nnk | grep -A3 -Ei 'vga|3d|display'nvidia-smi가 GPU와 통신할 수 없다면, Docker 구성부터 확인할 문제는 아닙니다.
Docker에 이미 NVIDIA 런타임이 있는지 확인
docker info | grep -i nvidia
ps aux | grep '[d]ockerd'현재 ZimaOS는 NVIDIA 런타임을 실제로 사용하지 않는 시스템에서도 대개 Docker를 NVIDIA 런타임을 사용할 수 있는 상태로 시작합니다.
ZimaOS 런타임 모델 사용
현재 ZimaOS NVIDIA Docker 런타임 가이드에는 다음과 같이 나와 있습니다.
services:
my-gpu-app:
image: your/image
runtime: nvidia
ipc: host
environment:
NVIDIA_VISIBLE_DEVICES: all다른 컨테이너에 Toolkit을 설치해도 작동하지 않는 이유
NVIDIA Container Toolkit은 호스트의 Docker/containerd와 통합됩니다. NVIDIA의 NVIDIA Container Toolkit 설치 가이드에서는 nvidia-ctk runtime configure를 사용해 호스트 Docker 구성을 수정하고 Docker를 다시 시작합니다.
ZimaOS에 apt 지침을 복사하지 마세요
NVIDIA의 설치 가이드는 호스트 패키지 관리자를 사용하는 지원 대상 Debian/RPM 계열 배포판을 기준으로 합니다. 현재 ZimaOS는 이러한 방식으로 관리되지 않으므로, 호스트 패키지 설치 지침이 어플라이언스 이미지 및 업데이트 모델과 충돌할 수 있습니다.
컨테이너에서 GPU 액세스 테스트
호스트 드라이버와 런타임이 정상적으로 작동하면, GPU 사용이 설정된 컨테이너나 대상 앱에서 장치가 실제로 컨테이너 내부에 표시되는지 확인하세요.
GTX 1050의 작업별 한계
GTX 1050은 일부 NVENC/NVDEC 트랜스코딩에는 충분할 수 있지만, 최신 Immich 머신 러닝과 같은 AI 작업에는 CUDA, VRAM, 모델 및 프레임워크와 관련해 더 엄격한 요구 사항이 있을 수 있습니다. “Docker가 GPU를 인식한다”는 사실만으로 모든 앱에서 GPU를 지원하는 것은 아닙니다.
런타임 설정을 변경하기 전에 앱 구성 백업하기
되돌릴 수 있는 방법을 모른다면 Docker 서비스 파일이나 런타임 구성을 수동으로 바꾸지 마세요. 잘못된 호스트 런타임 구성은 GPU 컨테이너뿐 아니라 모든 Docker 앱을 중단시킬 수 있습니다.
현재 GPU 컨테이너 가이드에서 현재 방식과 기존 방식의 소프트웨어 경계에 대해 자세히 알아볼 수 있습니다.
대상 앱 내부의 런타임 확인
호스트의 nvidia-smi는 ZimaOS 호스트 드라이버가 그래픽 카드를 인식한다는 것만 보여 줍니다. 실제 GPU 사용이 설정된 컨테이너에서 셸을 열고 해당 컨테이너의 장치와 런타임을 확인하세요. 그렇지 않으면 호스트 GPU는 정상으로 보여도 앱이 아무 표시 없이 CPU로 전환될 수 있습니다.
트랜스코딩과 AI 호환성은 별개입니다
NVENC/NVDEC 지원, CUDA 컴퓨팅 성능, VRAM, 애플리케이션별 프레임워크는 서로 다른 제약 조건입니다. Plex/Jellyfin 트랜스코딩이 가능한 그래픽 카드라도 최신 ML 모델을 실행하기에는 너무 오래되었거나 메모리가 부족할 수 있습니다.
자주 묻는 질문
ZimaOS에 nvidia-container-toolkit을 apt로 설치해야 하나요?
아니요. 호스트를 Ubuntu처럼 취급하지 말고 현재 ZimaOS NVIDIA 런타임 경로를 사용하세요.
Alpine Docker 내부에 툴킷을 설치할 수 있나요?
아니요. Docker 호스트에 런타임 통합이 갖춰져 있어야 합니다.
Docker가 NVIDIA GPU를 인식하는지 어떻게 알 수 있나요?
docker info, Docker 데몬 명령어와 런타임을 확인한 다음, 대상 컨테이너 내부에서 GPU에 액세스할 수 있는지 확인하세요.
호스트의 nvidia-smi가 Immich ML의 작동을 보장하나요?
아니요. 이는 호스트 드라이버에서 GPU를 인식한다는 뜻일 뿐입니다. 컨테이너와 애플리케이션에도 호환되는 CUDA/VRAM/런타임 지원이 필요합니다.
