# Ubuntu veya Debian'a NVIDIA sürücülerini ve CUDA'yı kurun

> GPU sunucuya NVIDIA veri merkezi sürücüsünü ubuntu-drivers veya NVIDIA deposuyla kurun, CUDA araç setini ekleyin ve nvidia-smi ile nvcc ile doğrulayın.

Zorluk: Orta

GPU sunucunuzdaki NVIDIA GPU'yu herhangi bir yazılımın kullanabilmesi için önce NVIDIA **sürücüsü** gerekir. Çoğu yapay zeka aracı ve konteyner başka bir şeye ihtiyaç duymaz; **CUDA araç seti** CUDA kodunu kendiniz derlemek içindir. Bu rehber ikisini de Canonical, Debian ve NVIDIA'nın belgelediği şekilde kurar.

## Başlamadan önce

- **Özel NVIDIA GPU'lu** bir GPU VPS, GPU VDS veya GPU'lu dedicated sunucu. Paylaşımlı vGPU için [GPU sunucular: başlangıç](/guides/gpu-servers-getting-started) rehberindeki nota bakın.
- Tamamen güncellenmiş ve yeniden başlatılmış Ubuntu 24.04 LTS veya 26.04 LTS ya da Debian 12 veya 13:

```bash
sudo apt update && sudo apt full-upgrade
sudo reboot
```

- GPU'nun göründüğünü kontrol edin: `lspci | grep -i nvidia`.
- Secure Boot'u kontrol edin: `mokutil --sb-state` (gerekirse `mokutil` kurun).

## 1. adım: Sürücüyü kurun

**Ubuntu**

Canonical'ın aracı doğru veri merkezi sürücüsünü seçer ve önceden derlenmiş, imzalı modüller kurar. Adayları listeleyin, ardından bir dal kurun; örneğin Canonical'ın belgelerinde kullandığı 535 dalı. Kendi listenizden bir dal seçin:

```bash
sudo ubuntu-drivers list --gpgpu
sudo ubuntu-drivers install --gpgpu nvidia:535-server
```

Ad vermeden `sudo ubuntu-drivers install --gpgpu` çalıştırmak bunun yerine önerilen dalı kurar. Ardından `nvidia-smi` içeren araçları kurun; numaraları sürücü dalıyla aynı olmalıdır:

```bash
sudo apt install nvidia-utils-535-server
sudo reboot
```
**Debian 13**

APT kaynaklarınızda `trixie` ve `trixie-security` için `contrib`, `non-free` ve `non-free-firmware` bileşenlerini açın, ardından:

```bash
sudo apt update
sudo apt install linux-headers-amd64
sudo apt install nvidia-kernel-dkms nvidia-driver
sudo reboot
```

Debian wiki'si her sürücü serisinin hangi GPU kuşaklarını desteklediğini ve açık modül türünün (`nvidia-open-kernel-dkms`) durumunu listeler; GPU'nuz için kontrol edin. En yeni GPU kuşakları için bunun yerine NVIDIA deposunu kullanın (sonraki sekme).
**NVIDIA deposu**

NVIDIA'nın kendi deposu Ubuntu ve Debian için en yeni sürücüleri içerir. Dağıtım adı olarak `ubuntu2404`, `ubuntu2604`, `debian12` veya `debian13` kullanın:

```bash
sudo apt install linux-headers-$(uname -r)
wget https://developer.download.nvidia.com/compute/cuda/repos/ubuntu2404/x86_64/cuda-keyring_1.1-1_all.deb
sudo dpkg -i cuda-keyring_1.1-1_all.deb
sudo apt update
sudo apt install nvidia-open
sudo reboot
```

Ekransız bir hesaplama sunucusu için NVIDIA daha küçük bir seti de belgeler: `sudo apt -V install libnvidia-compute nvidia-dkms-open`. Debian'da önce `contrib` bileşenini açın.

Sürücüyü yalnızca **tek** bir kaynaktan kurun. Ubuntu'nun sürücü paketlerini NVIDIA deposuyla karıştırmak sürüm çakışmalarına yol açar.

**Doğrulama:**

```bash
nvidia-smi
```

Tablo GPU'nuzu, sürücü sürümünü ve sürücünün desteklediği en yüksek CUDA sürümünü gösterir.

## 2. adım: CUDA araç setini kurun (yalnızca CUDA kodu derlemek için)

Araç seti NVIDIA deposundan gelir. Anahtarlığı 1. adımda eklemediyseniz şimdi ekleyin (aynı `wget` ve `dpkg -i` satırları), ardından:

```bash
sudo apt update
sudo apt install cuda-toolkit
```

Araç seti sürücü **kurmaz**. Derleyicisini yolunuza ekleyin; klasör adı sürümü taşır, bu yüzden önce kontrol edin:

```bash
ls -d /usr/local/cuda*
echo 'export PATH=/usr/local/cuda/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
```

`/usr/local/cuda` yoksa bunun yerine `ls` komutunun yazdığı sürümlü klasörü kullanın.

**Doğrulama:** `nvcc --version` CUDA derleyici sürümünü yazar.

## 3. adım: Sürücüyü güncel tutun

- Ubuntu sürücü paketleri `sudo apt update && sudo apt upgrade` ile güncellenir. Sürücü güncellemesinden sonra yeniden başlatın.
- NVIDIA deposunda tek bir dalda kalmanız gerekiyorsa NVIDIA sürüm sabitleme paketlerini (`nvidia-driver-pinning-…`) belgeler.

## Sorun giderme

**`Failed to initialize NVML: Driver/library version mismatch`.** Sürücü güncellendi ama eski çekirdek modülü hâlâ yüklü. Yeniden başlatın.

**`NVIDIA-SMI has failed because it couldn't communicate with the NVIDIA driver`.** Modül yüklenmedi. DKMS sürücülü Secure Boot sistemlerinde MOK anahtarını kaydedin veya Ubuntu'nun imzalı sürücülerini kullanın; ayrıca `dkms status` ve `dmesg | grep -i nvidia` çıktılarına bakın. Daha fazlası [GPU sorunlarını giderme](/guides/gpu-troubleshooting) rehberinde.

**`apt` NVIDIA paketleri arasında çakışma bildiriyor.** İki kaynaktan sürücüler karışmış. Onları `dpkg -l | grep -i nvidia` ile listeleyin, bir kaynağın paketlerini adlarıyla `sudo apt purge` kullanarak kaldırın, yeniden başlatın ve tek kaynakta kalın.

**`nvcc: command not found`.** Araç seti kurulu ama `PATH` üzerinde değil; bkz. 2. adım.

## Sonraki adımlar

- GPU'lu konteynerler: [Docker konteynerlerinde GPU](/guides/gpu-in-docker-containers).
- Bir model sunun: [vLLM kurulumu](/guides/install-vllm) veya [Ollama kurulumu](/guides/install-ollama).

## Sık sorulan sorular

### Yapay zeka uygulamalarını çalıştırmak için CUDA araç seti gerekir mi?

Genellikle hayır. Çoğu uygulama ve konteyner imajı kendi CUDA kitaplıklarını getirir ve yalnızca sürücüye ihtiyaç duyar. Araç setini CUDA kodunu kendiniz derlediğinizde kurun.

### Hangi sürücü sürümünü kurmalıyım?

ubuntu-drivers'ın hesaplama için önerdiğini veya NVIDIA deposundaki güncel dalı. Yazılımınızın gereksinimlerine bakın: yeni CUDA sürümleri daha yeni sürücüler ister.

### Bu, paylaşımlı vGPU için de geçerli mi?

Hayır. Paylaşımlı vGPU, sunucudaki (host) vGPU yazılımıyla uyumlu vGPU konuk sürücüsünü kullanır; imajlarımız bu sürücüyle gelir. Bu rehberdeki sürücüyü onun üzerine kurmayın. Yeniden kurmak için hizmet bilgilerinizde listelenen veya HyperDC desteğinin verdiği sürümü kullanın.

### Secure Boot önemli mi?

Secure Boot açık sistemlerde çekirdek modüllerinin imzalı olması gerekir. Ubuntu'nun ubuntu-drivers aracı önceden derlenmiş imzalı sürücüler kurar; DKMS ile derlenen sürücüler kayıtlı bir makine sahibi anahtarı (MOK) ister.

---

Kaynak: <https://hyperdc.com/tr/guides/products/install-nvidia-driver-cuda>\
Son güncelleme: 2026-10-16