Skip to content

Instantly share code, notes, and snippets.

@BEEugene
BEEugene / workaround-post.md
Created September 29, 2026 20:02
Recovering Docker Desktop (WSL2) after a forced power-off without factory reset: isocache + bbolt DBs + ext4 repair recipe

Recovering Docker Desktop (WSL2 backend) after a forced power-off — without factory reset

After a hard power-off (power loss / power button) Docker Desktop with the WSL2 backend may fail to start forever, and none of the usual advice (wsl --update, reinstall, AV exclusions) helps. The GUI only shows "Docker Desktop is unable to start". This is a writeup of a full recovery on Docker Desktop 4.91 / WSL 2.7.13 / Windows 11 26200 — volumes survived, no factory reset needed.

Symptoms (in the order you'll meet them)

  1. wsl-bootstrap dies mounting the base image:
    Error: preparing environment: setting up root fs: mounting base image
    .../docker-desktop.iso on /tmp/docker-desktop-root-ro: running mount -o ro,exec