현재 ZimaOS에서는 호스트에 apt로 NVIDIA Container Toolkit을 설치하는 Ubuntu 안내를 따르지 마세요. ZimaOS에는 자체 NVIDIA 드라이버/런타임 통합 기능이 있으며, 현재 Docker 앱 문서에서는 runtime: nvidia와 NVIDIA_VISIBLE_DEVICES를 사용해 GPU 컨테이너를 구성합니다.
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를 시작하는 경우가 많습니다.
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 모델에는 너무 오래되었거나 성능과 메모리가 부족할 수 있습니다.
FAQ
ZimaOS에 nvidia-container-toolkit을 apt로 설치해야 하나요?
아니요. 호스트를 Ubuntu처럼 취급하지 말고 현재 ZimaOS NVIDIA 런타임 경로를 사용하세요.
Alpine Docker 내부에 Toolkit을 설치할 수 있나요?
아니요. 런타임 통합 기능은 Docker 호스트에 있어야 합니다.
Docker가 NVIDIA를 인식하는지 어떻게 알 수 있나요?
docker info, Docker 데몬 명령 및 런타임을 확인한 다음 대상 컨테이너 내부에서 GPU 액세스를 검증하세요.
호스트에서 nvidia-smi가 작동하면 Immich ML도 작동한다는 뜻인가요?
아니요. 호스트 드라이버가 GPU를 인식한다는 뜻일 뿐이며, 컨테이너와 애플리케이션에도 호환되는 CUDA/VRAM/런타임 지원이 필요합니다.
