docs: update WSL2 hardware acceleration note (#37603)

* docs: update WSL2 hardware acceleration note for improved UI performance

* space

* clarify
This commit is contained in:
David
2026-03-07 20:23:20 -06:00
committed by GitHub
parent 6a3dcc74e8
commit acec60d19e

View File

@@ -38,7 +38,7 @@ scons -u -j$(nproc)
Follow [these instructions](https://docs.microsoft.com/en-us/windows/wsl/install) to setup the WSL and install the `Ubuntu-24.04` distribution. Once your Ubuntu WSL environment is setup, follow the Linux setup instructions to finish setting up your environment. See [these instructions](https://learn.microsoft.com/en-us/windows/wsl/tutorials/gui-apps) for running GUI apps.
**NOTE**: If you are running WSL and any GUIs are failing (segfaulting or other strange issues) even after following the steps above, you may need to enable software rendering with `LIBGL_ALWAYS_SOFTWARE=1`, e.g. `LIBGL_ALWAYS_SOFTWARE=1 selfdrive/ui/ui`.
**NOTE**: If you are running WSL 2 and experiencing performance issues with the UI or simulator, you may need to explicitly enable hardware acceleration by setting `GALLIUM_DRIVER=d3d12` before commands. Add `export GALLIUM_DRIVER=d3d12` to your `~/.bashrc` file to make it automatic for future sessions.
## CTF
Learn about the openpilot ecosystem and tools by playing our [CTF](/tools/CTF.md).