GPU - Bazzite GPU Configuration¶

Overview¶

Bazzite supports NVIDIA, AMD, and Intel GPUs. This skill covers NVIDIA driver configuration, Optimus laptops, GPU switching, and related drivers.

Quick Reference¶

NVIDIA Configuration¶

Configure NVIDIA¶

# Interactive NVIDIA configuration
ujust config-nvidia

# Same command
ujust nvidia

Options: - kargs - Set kernel arguments - test-cuda - Test CUDA functionality - firefox-vaapi - Enable Firefox hardware acceleration

Kernel Arguments¶

ujust config-nvidia kargs

Sets recommended kernel parameters for NVIDIA: - nvidia_drm.modeset=1 - nvidia_drm.fbdev=1

Test CUDA¶

ujust config-nvidia test-cuda

Runs CUDA sample to verify GPU compute.

Firefox VA-API¶

ujust config-nvidia firefox-vaapi

Enables hardware video acceleration in Firefox.

NVK (Open-Source)¶

Toggle NVK¶

# Switch between NVIDIA proprietary and NVK
ujust toggle-nvk

NVK: - Mesa's open-source Vulkan driver for NVIDIA - Requires newer GPUs (Turing+) - Part of nvidia-open images

NVIDIA: - Proprietary drivers - CUDA support - Better compatibility for older GPUs

Reboot required after switching.

Optimus Laptops¶

Configure Optimus¶

# Configure NVIDIA Optimus power management
ujust config-nvidia-optimus

Options: - power-management - Power state management

Enable GPU Switcher¶

# Enable supergfxctl for GPU switching
ujust enable-supergfxctl

supergfxctl allows: - Switching between iGPU and dGPU - Power management modes - Profile selection

Modes: - Integrated - Intel/AMD iGPU only (power saving) - Hybrid - Both GPUs, NVIDIA on-demand - Dedicated - NVIDIA only (performance)

Broadcom WiFi¶

Configure Broadcom¶

# Enable/disable Broadcom WL driver
ujust config-broadcom-wl

Required for certain Broadcom wireless chips that don't work with open-source drivers.

Options: - enable - Enable Broadcom WL driver - disable - Disable and use open-source

Mesa Testing¶

Mesa Git Builds¶

# Manage Mesa Git builds
ujust _mesa-git

Options: - Download latest Mesa Git - Install for testing - Cleanup old builds

Warning: For testing only. May cause instability.

Common Workflows¶

Fresh NVIDIA Setup¶

# Configure kernel args
ujust config-nvidia kargs

# Reboot
systemctl reboot

# Test CUDA
ujust config-nvidia test-cuda

# Enable Firefox HW accel
ujust config-nvidia firefox-vaapi

Laptop Power Saving¶

# Enable GPU switcher
ujust enable-supergfxctl

# Use supergfxctl to select mode
supergfxctl -m integrated

Try NVK Driver¶

# Switch to NVK
ujust toggle-nvk

# Reboot
systemctl reboot

# Verify
vulkaninfo | grep driverName

Verification¶

Check NVIDIA Driver¶

# Driver version
nvidia-smi

# Module loaded
lsmod | grep nvidia

# Vulkan info
vulkaninfo | head -20

Check GPU in Use¶

# Current GPU
glxinfo | grep "OpenGL renderer"

# For Vulkan
vulkaninfo | grep deviceName

Check Power Mode¶

# With supergfxctl
supergfxctl -g

# NVIDIA power state
cat /sys/bus/pci/devices/0000:01:00.0/power/runtime_status

Troubleshooting¶

NVIDIA Driver Not Loading¶

Check secure boot:

# If secure boot enabled, enroll key
ujust enroll-secure-boot-key

Check kernel args:

rpm-ostree kargs

Reinstall:

ujust config-nvidia kargs
systemctl reboot

Black Screen After NVK Switch¶

Boot to previous deployment: 1. At GRUB, select previous boot entry 2. Once booted:

ujust toggle-nvk
systemctl reboot

Optimus Not Switching¶

Check supergfxctl:

systemctl status supergfxd
supergfxctl -g

Manual switch:

supergfxctl -m <mode>
# hybrid, integrated, or dedicated

CUDA Not Working¶

Check installation:

nvidia-smi
ujust config-nvidia test-cuda

Reinstall CUDA toolkit if needed.

Cross-References¶

• bazzite:boot - Secure boot key enrollment
• bazzite:gaming - Gaming performance
• bazzite-ai:configure - GPU containers