본문 바로가기
  • AI 개발자가 될래요
리눅스

[Linux/리눅스] Error response from daemon: unknown or invalid runtime name: nvidia / 도커 nvidia 에러 해결법

by 꿀개 2025. 2. 10.

[Linux/리눅스] Error response from daemon: unknown or invalid runtime name: nvidia / 도커 nvidia 에러 해결법

 

최근 그래픽 드라이버의 알 수 없는 오류로 nvidia driver를 재설치했다.

그 뒤 docker를 실행시키려니 다음과 같은 에러 메세지가 나왔다.

 

Error response from daemon: unknown or invalid runtime name: nvidia

 

에러 원인

해당 오류 메시지는 Docker가 nvidia 런타임을 인식하지 못한다는 것을 나타낸다.

보통 이 문제는 NVIDIA GPU를 사용하는 Docker 컨테이너를 실행하려고 할 때 발생하며,

NVIDIA Docker 런타임이 제대로 설치되지 않았거나 설정이 잘못된 경우에 발생할 수 있다.

 

해결법

NVIDIA Docker 관련 패키지가 설치되어 있는지 확인

dpkg -l | grep nvidia-docker

 

나의 경우에는 해당 명령어를 쳐도 아무것도 출력되지 않았다. 설치되어있지 않음을 의미한다.

 

NVIDIA Container Toolkit 설치

아래 nvidia official 링크를 참고했다.

https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html

 

Installing the NVIDIA Container Toolkit — NVIDIA Container Toolkit

You installed a supported container engine (Docker, Containerd, CRI-O, Podman).

docs.nvidia.com

 

1. APT 설치

아래 명령어들을 순차적으로 실행하면 된다.

nvidia-container-toolkit을 설치하기 위한 과정이라고 보면 된다.

curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg \
  && curl -s -L https://nvidia.github.io/libnvidia-container/stable/deb/nvidia-container-toolkit.list | \
    sed 's#deb https://#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://#g' | \
    sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list

 

sudo apt-get update

 

sudo apt-get install -y nvidia-container-toolkit

 

2. Docker 설정

NVIDIA Docker 런타임을 실행시키는 명령어이다.

순차적으로 실행하면 된다.

sudo nvidia-ctk runtime configure --runtime=docker

 

sudo systemctl restart docker

 

모든 과정을 거치고 docker를 실행하면 문제가 해결된 것을 볼 수 있다.