Making musl and proprietary NVIDIA drivers work together

A closer look at Making musl and proprietary NVIDIA drivers work together

Why musl systems struggle with NVIDIA drivers

Proprietary NVIDIA userland libraries are built for glibc, so musl-based distributions can’t use them as-is. NVIDIA supplies an out-of-tree kernel driver and vendor userland libraries, while other vendors generally use in-tree kernel drivers plus Mesa userspace. A free driver (Nouveau and NVK) exists, but performance can be significantly lower and support varies by GPU generation. The post summarizes experiments to make the proprietary driver work on musl systems.

What the author actually did to make it work

They opened pull requests for both the 580 and 620 NVIDIA driver branches for x86_64 and aarch64, and documented the steps. Key actions include switching the distribution to use GLVND (so vendor-neutral OpenGL dispatch works), using the gcompat project as a glibc-compat shim (loader plus libgcompat.so.0), and using patchelf to sanitize NVIDIA libraries and add libgcompat as a dependency. The author notes the latest tagged gcompat lacked some symbols required by the driver, so they bumped to the latest git revision.

Who will find this useful

Anyone running or maintaining a musl-based distribution who needs to support proprietary NVIDIA drivers will find the details relevant - packagers and distro developers in particular. Users with GPUs that require the proprietary driver (the post says many cards newer than GTX 600 but older than GTX 1600 typically need the proprietary driver for acceptable behavior) will care about these packaging and compatibility techniques.

Questions people ask about Making musl and proprietary NVIDIA drivers work together

Does this require switching Mesa or other system components?

Yes - the author switched Chimera to GLVND and rebuilt Mesa with GLVND to avoid Mesa’s builtin dispatch code.

Can I just use gcompat release tarballs?

The post says the latest tagged gcompat release did not provide all symbols the proprietary driver needs, so they used the latest git revision instead.

What tool handles changing driver binaries to work on musl?

They used patchelf to remove unnecessary DT_NEEDED entries, set a new dynamic linker where needed, and add libgcompat.so.0 as a dependency.

Making musl and proprietary NVIDIA drivers work together was shared on NexURLs by NexURLs on November 6, 2026, in Tech & AI.