coco
97 lines
2.6 KiB
Markdown
97 lines
2.6 KiB
Markdown
|
|
This is a very common error when running GUI apps (like gedit, firefox, GNOME apps, etc.) in WSL2 Ubuntu (especially Ubuntu 24.04). It happens because Mesa (the OpenGL implementation) tries to use the Zink driver (OpenGL over Vulkan) but fails to initialize the D3D12 backend that WSLg uses for GPU acceleration.Quickest Fixes (Try in This Order)
|
|
|
|
1. Force the D3D12 Gallium driver (most effective for most people):
|
|
|
|
bash
|
|
|
|
```bash
|
|
export GALLIUM_DRIVER=d3d12
|
|
```
|
|
|
|
Then launch your GUI app, e.g.:
|
|
|
|
bash
|
|
|
|
```bash
|
|
gedit
|
|
```
|
|
|
|
or
|
|
|
|
bash
|
|
|
|
```bash
|
|
firefox
|
|
```
|
|
|
|
To make it permanent, add this line to your ~/.bashrc or ~/.profile:
|
|
|
|
bash
|
|
|
|
```bash
|
|
echo 'export GALLIUM_DRIVER=d3d12' >> ~/.bashrc
|
|
source ~/.bashrc
|
|
```
|
|
|
|
2. Install missing libraries (often helps even if warnings remain):
|
|
|
|
bash
|
|
|
|
```bash
|
|
sudo apt update
|
|
sudo apt install libgles2 libgl1-mesa-dri mesa-utils libglx-mesa0
|
|
```
|
|
|
|
3. Fallback to software rendering (if the above doesn't work or you don't need GPU accel):
|
|
|
|
bash
|
|
|
|
```bash
|
|
export LIBGL_ALWAYS_SOFTWARE=1
|
|
```
|
|
|
|
Add it to ~/.bashrc the same way as above.
|
|
|
|
Additional Steps if It Still Fails
|
|
|
|
- Update everything and reboot WSL:
|
|
|
|
bash
|
|
|
|
```bash
|
|
sudo apt update && sudo apt full-upgrade -y
|
|
```
|
|
|
|
Then from PowerShell (as Administrator):
|
|
|
|
powershell
|
|
|
|
```powershell
|
|
wsl --shutdown
|
|
```
|
|
|
|
Restart your WSL Ubuntu.
|
|
- Make sure WSL is up to date: In PowerShell:
|
|
|
|
powershell
|
|
|
|
```powershell
|
|
wsl --update
|
|
```
|
|
|
|
- If you're on Ubuntu 24.04, some users report better stability by switching to Ubuntu 22.04 from the Microsoft Store (or installing it fresh).
|
|
- For NVIDIA users wanting real hardware acceleration:
|
|
- Ensure you have the latest NVIDIA driver on Windows.
|
|
- Install CUDA on WSL if needed (see Ubuntu's official guide).
|
|
- Sometimes the d3d12 driver still works better than native NVIDIA in WSLg right now.
|
|
|
|
Test if OpenGL is WorkingAfter applying a fix, run:
|
|
|
|
bash
|
|
|
|
```bash
|
|
glxinfo -B
|
|
```
|
|
|
|
You should see something like OpenGL renderer string: llvmpipe (software) or a D3D12-based renderer instead of Zink errors.The warnings may still appear but the app should launch normally. This issue has been ongoing for a while in WSLg + recent Mesa, but the GALLIUM_DRIVER=d3d12 workaround resolves it for the vast majority of users.Let me know your exact Ubuntu version (cat /etc/os-release), whether you're using NVIDIA/AMD/Intel GPU, and which GUI app fails — I can give more targeted advice. |