- WSL2 initial setup
- Ubunt 24.04 installer from Microsoft Store
- CUDA drivers
- CUDNN drivers
- Openpilot Install
Windows Subsystem for Linux 2 (WSL2) should provide a similar experience to native Ubuntu apart from some known issues listed here:
Issues have been reported with developers attempting to run Openpilot with webcam support. Successfully achieving openpilot webcam support in WSL2 will likely involve attaching USB devices to WSL and rebuilding the Kernel.
If you are running WSL and any GUIs are failing (segfaulting or other strange issues) even after installing a GPU driver, you may need to enable software rendering with LIBGL_ALWAYS_SOFTWARE=1, e.g. LIBGL_ALWAYS_SOFTWARE=1 selfdrive/ui/ui.
Because of WSL2's virtual IP address configuration, interprocess communication with processes running on a remote host will have issues communicating with processes running in WSL2. For this reason, tools like Camera stream are not supported for WSL developers.
Running rerun with the wayland window manager can cause crashing. To mitigate this run with the WAYLAND_DISPLAY environment variable unset (ie. WAYLAND_DISPLAY= tools/rerun/run.sh --demo). See Rerun's WSL2 troubleshooting section for more tips.
Developers have observed instances of fuzzy diagonal lines appearing in UI apps. The cause is currently unknown but it has been found that power cycling one's PC fixes it.
