Immediate Fix
To resolve the “Docker Desktop requires a newer WSL kernel version” error immediately, you must update the Windows Subsystem for Linux (WSL) component via the command line.
Open PowerShell or Command Prompt with Administrative privileges and execute the following command:
wsl --updateOnce the update completes, you should restart Docker Desktop. Use the table below to verify the update status and command options.
| Command | Description |
|---|---|
| wsl –update | Downloads and installs the latest Linux kernel version. |
| wsl –status | Checks the current kernel version and default distribution. |
| wsl –shutdown | Forces a restart of the WSL subsystem to apply changes. |
Technical Explanation
Docker Desktop on Windows uses the WSL 2 backend as its primary virtualization engine. This allows Docker to run Linux containers natively on Windows without the overhead of a traditional Virtual Machine.
The error occurs because Docker Desktop identifies that the installed Linux kernel is below the minimum version required for its current build. This usually happens after a Docker update or a fresh installation on an older Windows build.
The WSL kernel is separate from the standard Windows OS updates. While Windows Update manages the OS, the WSL kernel often requires manual triggering or specific “Optional Update” permissions to stay current.
Alternative Methods
1. Manual MSI Installation
If the command line update fails due to network restrictions or proxy settings, you can download the update package manually. Microsoft provides an MSI installer for the WSL 2 Linux kernel update package for x64 machines.
Download the “wsl_update_x64.msi” file from the official Microsoft documentation and run it to patch the kernel manually.
2. Enabling Microsoft Updates
You can automate this process by ensuring Windows Update handles Linux kernel patches. Navigate to Settings > Windows Update > Advanced Options.
Toggle the switch for “Receive updates for other Microsoft products when you update Windows” to On. This ensures the WSL kernel remains compatible with future Docker Desktop releases.
3. Forcing a WSL Shutdown
Sometimes the update installs correctly but the kernel remains cached in memory. Run the following command to ensure the new kernel version is loaded:
wsl --shutdown