Skip to content

docs: add NVIDIA configuration page (nvidia-open + Wayland) - #624

Open
VECTORG99 wants to merge 1 commit into
CachyOS:nextfrom
VECTORG99:next
Open

docs: add NVIDIA configuration page (nvidia-open + Wayland)#624
VECTORG99 wants to merge 1 commit into
CachyOS:nextfrom
VECTORG99:next

Conversation

@VECTORG99

Copy link
Copy Markdown

Summary

The wiki had no dedicated NVIDIA page — NVIDIA was only mentioned inside features/kernel.mdx, features/chwd/chwd.mdx, configuration/dual_gpu.mdx and configuration/post_install_setup.mdx. This PR adds a dedicated configuration/nvidia.mdx page documenting a known-good nvidia-open + Wayland (Hyprland) setup.

What the page covers

  • nvidia-open vs nvidia: what the open kernel modules are, GPU support (Turing+), and the GSP firmware requirement (the NVreg_EnableGpuFirmware=0 option is ignored with open modules).
  • Installation: via chwd or the CachyOS precompiled module packages (linux-cachyos-nvidia-open, linux-cachyos-lts-nvidia-open, ...).
  • Wayland / DRM KMS: nvidia_drm.modeset=1 and fbdev=1, plus early modesetting through /etc/mkinitcpio.conf MODULES and mkinitcpio -P.
  • Kernel module options: NVreg_DynamicPowerManagement=0x02 (power management for RTX 30 series) and the GSP firmware caveat.
  • Suspend/resume: NVreg_PreserveVideoMemoryAllocations=1 and the distinction between the nvidia-suspend/nvidia-hibernate/nvidia-resume systemd services and NVreg_UseKernelSuspendNotifiers=1 (kernel-level notifiers, requires early module load in the initramfs, mutually exclusive with the services).
  • Hyprland specifics: recommended LIBVA_DRIVER_NAME, GBM_BACKEND, __GLX_VENDOR_LIBRARY_NAME environment variables, plus hardware cursor notes.

Verification

The content is based on a verified working setup: RTX 3060, nvidia-open 610.57.04, kernel 7.1.8-1-cachyos. The wiki builds successfully (bun run build), and the new page + sidebar entry are generated correctly.

Note on navigation

The Configuration sidebar in astro.config.mjs is an explicit list (not auto-discovered), so a minimal entry for the new page was added there. No other files were modified.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant