Updating wsl: update failed: wsl.exe --update n--web-download not supported

Hello Docker Community,

I’m currently encountering an issue with Docker on my Windows machine, and I’m seeking assistance from the community to help me troubleshoot and resolve the issue.

I’m experiencing difficulties starting Docker. The error message I’m encountering is:
“updating wsl: update failed: wsl.exe --update n–web-download not supported”

Operating System: Windows 10 home
Docker Version: 24.0.6, build ed223bc

Steps Taken:
I have updated WSL to the latest version.
Set the default WSL version to 2.
Enabled virtualization feature

Kindly find attached images for more details

It doesn’t look like a Docker related issue. Your Docker Desktop doesn’t even use WSL according the the screenshot. Otherwise you would have “docker-desktop” and “docker-desktop-data” distributions. Maybe I missed something so can you tell us why you think it is related to Docker?

I have the same problem with automatic update of wsl.
Latest version of Docker Desktop ( crashes on start with same error message.

If I try manual updating of wsl - Docker Desktop also doesn’t start. It complains of wsl latest version. But I have this one already. And I don’t use it at all.

What should I do to repair Docker Desktop installation?

Since ther eis another similar issue, I wonder does the error message really says “n–web-download” and not just “–web-download”?

I have the same problem with automatic update of wsl.
Were you able to resolve this issue?

My error message doesn’t contain “-n”, it contains “–web-download”.

I can not run the Docker, the msg is below;

updating wsl update failed: wsl.exe - update – web-download not supported

I’m very needed to solve this problem

… and still you didn’t seem to have opened and read the link that @rimelek shared.

I have the same problem.
wsl --update
says that i have the latest version.
OS Windows 10 Pro 22H2 (19045.2006)
Docker Desktop (
But when I start Docker Desktop it crushes with error:

Updating wsl: update failed: wsl.exe --update --web-download not supported

The link above didn’t help as I have Windows 10 Pro

When I run
wsl --help
there is no option --web-download for --update
only option --rollback

What helped:
I guess wsl version was outdated, but wsl --update didn’t work.
Followed the steps from “Manual installation steps for older versions of WSL” acticle.
Worked for me

And this is exactly what @meyay sugested in the topic which “didn’t help” you :slight_smile:, except from a different source, but that should have helped too.

Thanks for the link from the official MS docs :+1:

I tried the link provided but the error persists. Has anyone found a solution yet?? Running docker desktop 4.25.1 with wsl 2