# بررسی مدل کارت گرافیک
lspci | grep -i nvidia
# 01:00.0 VGA compatible controller: NVIDIA Corporation GA106 [GeForce RTX 3060] (rev a1)
 
# بررسی درایور فعلی
lsmod | grep -i nouveau
# (اگر nouveau لود شده، یعنی درایور آزاد در حال اجراست)
 
# بررسی نسخهٔ فعلی درایور (اگر نصب است)
nvidia-smi

# مشاهدهٔ درایورهای پیشنهادی برای کارت گرافیک شما
ubuntu-drivers devices
 
# خروجی نمونه:
# vendor   : NVIDIA Corporation
# model    : GA106 [GeForce RTX 3060]
# driver   : nvidia-driver-535 - distro non-free
# driver   : nvidia-driver-545 - distro non-free
# driver   : nvidia-driver-550 - distro non-free recommended
# driver   : xserver-xorg-video-nouveau - distro free builtin

# نصب درایور پیشنهادی (recommended)
sudo ubuntu-drivers autoinstall
 
# یا نصب نسخهٔ خاص
sudo apt install -y nvidia-driver-550

sudo reboot

# افزودن PPA
sudo add-apt-repository -y ppa:graphics-drivers/ppa
sudo apt update
 
# مشاهدهٔ درایورهای موجود
apt list --installed | grep nvidia-driver
 
# نصب آخرین نسخه
sudo apt install -y nvidia-driver-550

# بررسی نسخهٔ درایور
nvidia-smi
 
# خروجی نمونه:
# +-----------------------------------------------------------------------------+
# | NVIDIA-SMI 550.54.14    Driver Version: 550.54.14    CUDA Version: 12.4     |
# |-------------------------------+----------------------+----------------------+
# | GPU  Name        Persistence-M| Bus-Id        Disp.A | Volatile Uncorr. ECC|
# |   0  GeForce RTX 3060     Off | 00000000:01:00.0  On |                  N/A|
# |  30%  35C    P8    15W / 170W |    240MiB / 12288MiB |     18%      Default|
# +-------------------------------+----------------------+----------------------+

# بررسی بارگذاری ماژول
lsmod | grep nvidia
# nvidia              5627904  150
# nvidia_uvm           995328   8
# nvidia_modeset      1228800  13 nvidia_uvm
# nvidia_drm            61440  2
 
# بررسی نسخهٔ نصب‌شده
dpkg -l | grep nvidia-driver

# نسخهٔ کامل CUDA Toolkit
sudo apt install -y nvidia-cuda-toolkit
 
# بررسی نصب
nvcc --version
# nvcc: NVIDIA (R) Cuda compiler driver
# Cuda compilation tools, release 12.0

# افزودن کلید و مخزن NVIDIA CUDA
wget https://developer.download.nvidia.com/compute/cuda/repos/ubuntu2404/x86_64/cuda-ubuntu2404.key | sudo gpg --dearmor -o /usr/share/keyrings/cuda.gpg
echo "deb [signed-by=/usr/share/keyrings/cuda.gpg] https://developer.download.nvidia.com/compute/cuda/repos/ubuntu2404/x86_64/ /" | sudo tee /etc/apt/sources.list.d/cuda.list
 
sudo apt update
sudo apt install -y cuda-toolkit
 
# افزودن به PATH
echo 'export PATH=/usr/local/cuda/bin:$PATH' >> ~/.bashrc
echo 'export LD_LIBRARY_PATH=/usr/local/cuda/lib64:$LD_LIBRARY_PATH' >> ~/.bashrc
source ~/.bashrc

# مشاهدهٔ پروفایل فعلی
prime-select query
 
# خروجی نمونه:
# on-demand  (یا nvidia، intel، hybrid)
 
# تغییر به حالت NVIDIA فقط (performance بالا، باتری کم)
sudo prime-select nvidia
 
# تغییر به حالت Intel فقط (performance پایین، باتری زیاد)
sudo prime-select intel
 
# حالت on-demand (بهترین ترکیب — اجرای برنامه خاص با NVIDIA)
sudo prime-select on-demand
 
# ری‌استارت برای اعمال
sudo reboot

# اجرای Firefox با GPU NVIDIA
__NV_PRIME_RENDER_OFFLOAD=1 __GLX_VENDOR_LIBRARY_NAME=nvidia firefox
 
# یا با prime-run (اگر نصب است)
prime-run firefox
 
# اجرای Steam games با GPU NVIDIA
__NV_PRIME_RENDER_OFFLOAD=1 __GLX_VENDOR_LIBRARY_NAME=nvidia steam

# افزودن مخزن
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 update
sudo apt install -y nvidia-container-toolkit
 
# پیکربندی Docker
sudo nvidia-ctk runtime configure --runtime=docker
sudo systemctl restart docker
 
# تست
docker run --rm --gpus all nvidia/cuda:12.4.0-base-ubuntu22.04 nvidia-smi

# بوت به recovery mode یا TTY (Ctrl+Alt+F2)
# حذف درایور NVIDIA
sudo apt purge '*nvidia*'
sudo apt autoremove --purge
 
# ریبوت
sudo reboot
 
# نصب مجدد با نسخهٔ پایدارتر
sudo apt install -y nvidia-driver-535

# بررسی لاگ kernel
dmesg | grep -i nvidia
 
# بررسی بارگذاری ماژول
lsmod | grep nvidia
 
# بارگذاری دستی
sudo modprobe nvidia
 
# اگر خطای "Could not insert nvidia" داد، مشکل از Secure Boot است

# نصب مجدد ماژول برای kernel فعلی
sudo dkms install nvidia/550.54.14 -k $(uname -r)
 
# یا نصب مجدد کامل درایور
sudo apt install --reinstall nvidia-driver-550

# بررسی session فعلی
echo $XDG_SESSION_TYPE
# wayland  (یا x11)
 
# اگر Wayland است و مشکل دارید، به X11 سوییچ کنید:
# در صفحهٔ ورود (GDM) → چرخ‌دنده → Ubuntu on Xorg

# بررسی خروجی‌های صوتی
aplay -l | grep NVIDIA
 
# اگر کارت HDMI دیده نشد، ماژول را باز بارگذاری کنید
sudo alsa force-reload
 
# یا نصب pulseaudio volume control
sudo apt install -y pavucontrol
pavucontrol
# در تب Configuration، profile HDMI را فعال کنید

# غیرفعال‌کردن Hardware Acceleration در مرورگر
# در Firefox: about:config → media.ffmpeg.vaapi.enabled = false
 
# یا نصب درایور جدیدتر
sudo apt install -y nvidia-driver-550

# به‌روزرسانی فهرست
sudo apt update
 
# مشاهدهٔ درایور جدیدتر موجود
apt list --upgradable | grep nvidia
 
# ارتقا به نسخهٔ جدید
sudo apt install -y nvidia-driver-555  # (نسخهٔ جدیدتر)
 
# یا ارتقا با ubuntu-drivers
sudo ubuntu-drivers autoinstall