Yard Docs
Sign in

YRD-WSL-001: Windows Subsystem for Linux needs installing or updating

Docker Desktop on Windows needs WSL 2, which is missing or out of date.

Updated November 11, 2026 ยท 1 min read

Error YRD-WSL-001. Docker Desktop on Windows runs containers in WSL 2 (Windows Subsystem for Linux). It is not installed, or too old.

Fix it

  • Yard for desktop: press Fix it for me. Yard runs wsl --install --no-distribution (or wsl --update when WSL is there) and Windows asks once for an administrator. Restart the computer when Windows asks.
  • By hand: open PowerShell as administrator and run wsl --update, or wsl --install --no-distribution on a computer that never had WSL. Restart.

If WSL says virtualization is not enabled, see YRD-VIRT-001.

Was this page useful?
Edit this page