{
  "id": "docker/docker-daemon-not-running-wsl2",
  "signature": "error during connect: This error may indicate that the docker daemon is not running. (http://%2F%2F.%2Fpipe%2Fdocker_engine/v1.41/containers/json)",
  "signature_zh": "连接错误：此错误可能表示 Docker 守护进程未运行。（http://%2F%2F.%2Fpipe%2Fdocker_engine/v1.41/containers/json）",
  "regex": "error during connect: This error may indicate that the docker daemon is not running",
  "domain": "docker",
  "category": "runtime_error",
  "subcategory": null,
  "root_cause": "Docker Desktop for Windows fails to start the daemon when WSL2 integration is misconfigured or the WSL2 kernel is outdated.",
  "root_cause_type": "generic",
  "root_cause_zh": "当 WSL2 集成配置错误或 WSL2 内核过时时，适用于 Windows 的 Docker Desktop 无法启动守护进程。",
  "versions": [
    {
      "version": "Docker Desktop 4.20.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Docker Desktop 4.21.1",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "WSL2 kernel 5.15.90.1",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Windows 10 22H2",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Windows 11 23H2",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "Restarting Docker Desktop from the system tray",
      "why_fails": "If the underlying WSL2 integration is broken or kernel is outdated, restarting Docker Desktop alone does not fix the issue; the daemon will fail again immediately.",
      "fail_rate": 0.65,
      "condition": "",
      "sources": []
    },
    {
      "action": "Reinstalling Docker Desktop entirely",
      "why_fails": "The error is often caused by a stale WSL2 kernel or misconfigured .wslconfig, not by Docker Desktop installation files. Reinstalling is time-consuming and rarely resolves the root cause.",
      "fail_rate": 0.8,
      "condition": "",
      "sources": []
    },
    {
      "action": "Running 'wsl --shutdown' and then restarting Docker",
      "why_fails": "While this can temporarily clear state, it does not update the WSL2 kernel or fix integration settings; the error returns after the next system reboot.",
      "fail_rate": 0.55,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Update the WSL2 Linux kernel by running 'wsl --update' from an elevated PowerShell, then restart Docker Desktop.",
      "success_rate": 0.8,
      "how": "Update the WSL2 Linux kernel by running 'wsl --update' from an elevated PowerShell, then restart Docker Desktop.",
      "condition": "",
      "sources": []
    },
    {
      "action": "Disable and re-enable WSL2 integration in Docker Desktop: Settings > Resources > WSL Integration > toggle off all distros, apply, then toggle on the desired distro and restart.",
      "success_rate": 0.75,
      "how": "Disable and re-enable WSL2 integration in Docker Desktop: Settings > Resources > WSL Integration > toggle off all distros, apply, then toggle on the desired distro and restart.",
      "condition": "",
      "sources": []
    },
    {
      "action": "Manually set the WSL2 kernel path in %USERPROFILE%\\.wslconfig with a 'kernel=C:\\\\path\\\\to\\\\kernel' entry, then run 'wsl --shutdown' and restart Docker Desktop.",
      "success_rate": 0.7,
      "how": "Manually set the WSL2 kernel path in %USERPROFILE%\\.wslconfig with a 'kernel=C:\\\\path\\\\to\\\\kernel' entry, then run 'wsl --shutdown' and restart Docker Desktop.",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "通过以管理员身份运行的 PowerShell 执行 'wsl --update' 更新 WSL2 Linux 内核，然后重启 Docker Desktop。",
    "在 Docker Desktop 中禁用并重新启用 WSL2 集成：设置 > 资源 > WSL 集成 > 关闭所有发行版，应用，然后重新打开所需发行版并重启。",
    "在 %USERPROFILE%\\.wslconfig 中手动设置 WSL2 内核路径，例如 'kernel=C:\\\\path\\\\to\\\\kernel'，然后执行 'wsl --shutdown' 并重启 Docker Desktop。"
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://docs.docker.com/desktop/troubleshoot/topics/#wsl-2-integration",
  "official_doc_section": null,
  "error_code": null,
  "verification_tier": "ai_generated",
  "confidence": 0.85,
  "fix_success_rate": 0.82,
  "resolvable": "partial",
  "first_seen": "2023-05-12",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}