> ## Documentation Index
> Fetch the complete documentation index at: https://docs.baeum.ai.kr/llms.txt
> Use this file to discover all available pages before exploring further.

# NVIDIA Driver

GPU 가속(CUDA, PyTorch)을 사용하려면 드라이버를 먼저 설치해야 합니다.

## 사전 준비

* NVIDIA GPU 장착 시스템
* Ubuntu 24.04
* `sudo` 권한

## 설치 과정

<Steps>
  <Step title="드라이버 추천 목록 확인">
    ```bash theme={null}
    sudo apt update
    sudo apt install -y ubuntu-drivers-common
    ubuntu-drivers devices
    ```
  </Step>

  <Step title="권장 드라이버 설치">
    ```bash theme={null}
    sudo ubuntu-drivers install
    ```
  </Step>

  <Step title="재부팅">
    ```bash theme={null}
    sudo reboot
    ```
  </Step>
</Steps>

## 설치 확인하기

```bash theme={null}
nvidia-smi
```

GPU 모델과 드라이버 버전이 출력되면 정상입니다.

## 문제 해결

* **`nvidia-smi` 실패**: Secure Boot가 활성화되어 있으면 드라이버 로딩이 막힐 수 있습니다.
* **검은 화면/로그인 루프**: 복구 모드에서 이전 드라이버 정리 후 재설치합니다.

## 설치 점검 목록

* 관리자 권한/필수 도구 등 사전 요구사항을 먼저 확인했습니다.
* 설치 후 버전 확인 명령어(`--version`)를 실행해 정상 설치를 검증했습니다.
* PATH/환경변수 변경이 필요한 경우 터미널을 다시 열어 적용 여부를 확인했습니다.
* 문제가 생겼을 때를 대비해 설치 로그 또는 스크린샷을 남겼습니다.

## 관련 문서

<CardGroup cols={2}>
  <Card title="Setup 홈" icon="house" href="/setup/index">
    운영체제별 설치 흐름을 다시 확인합니다.
  </Card>

  <Card title="다음: NVIDIA CUDA Toolkit" icon="arrow-right" href="/setup/ubuntu/nvidia-cuda-toolkit">
    다음 설치 단계를 이어서 진행합니다.
  </Card>
</CardGroup>