Skip to main content

​
WSL 2 Setup on Windows (10 and 11 only)

WSL 2 is the recommended host for both the Docker Compose path and the bare-metal ./run path on Windows. Install it once and use the same Ubuntu distro for whichever track you pick on the Run the Project (Windows) page.
  1. Run the Windows PowerShell as Administrator
  2. Enable WSL by running the command: dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
  3. Enable the Virtual Machine Platform by running the following command: dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
  4. Restart the computer to apply the changes
  5. Install the WSL2 Update package (Note: If you are using Windows 11 skip this step)
    1. Download the WSL2 Linux kernel update package.
    2. Run the installer and follow the on-screen instructions.
  6. Open PowerShell as Administrator again
  7. Run the following command to set WSL2 as the default version: wsl --set-default-version 2
  8. Install Ubuntu from the Microsoft Store.
  9. Click Install and follow the on-screen instructions. (Note: Make sure to keep the set password)
  10. You’re all set, to make sure that you are successfully done you can run the following command: wsl --list --verbose You should see this

​
Next step

Continue with the Run the Project (Windows) guide. The Track 1 (Docker Compose) flow is the recommended path; once Docker Desktop is configured to use the WSL 2 backend with integration enabled for your Ubuntu distro, the standard docker compose up workflow runs identically to a native Linux host.