Openpilot on WSL2 Ubuntu 24.04

WSL installation steps

• WSL2 initial setup
• Ubunt 24.04 installer from Microsoft Store
• CUDA drivers
• CUDNN drivers
• Openpilot Install

Known issues

Windows Subsystem for Linux 2 (WSL2) should provide a similar experience to native Ubuntu apart from some known issues listed here:

Webcam support

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.

GUI issues

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.

IPC outside WSL2

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.

Rerun visualization tool

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.

GUI fuzzy diagonal lines

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.