{
  "id": "docker/volume-driver-not-supported",
  "signature": "Error response from daemon: create volume: volume driver \"local\" is not supported on this platform",
  "signature_zh": "守护进程响应错误：创建卷：此平台不支持卷驱动 \"local\"",
  "regex": "volume driver \"[\\w-]+\" is not supported on this platform",
  "domain": "docker",
  "category": "config_error",
  "subcategory": null,
  "root_cause": "The Docker installation is missing or has a misconfigured volume plugin for the 'local' driver, often due to incomplete installation on non-standard Linux distributions or Windows with WSL2 issues.",
  "root_cause_type": "generic",
  "root_cause_zh": "Docker 安装缺少或配置了错误的 'local' 驱动卷插件，通常由于在非标准 Linux 发行版或具有 WSL2 问题的 Windows 上安装不完整。",
  "versions": [
    {
      "version": "Docker Desktop 4.27.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Docker Engine 24.0.5",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Docker CE 25.0.1",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "",
      "why_fails": "The issue is often a missing plugin configuration, not the Docker engine itself; reinstalling may not fix the plugin path or driver registration.",
      "fail_rate": 0.5,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "The error is about the volume driver not being supported, not about directory existence; Docker will still fail to create the volume via the driver.",
      "fail_rate": 0.9,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "Other drivers may also be unsupported if the plugin infrastructure is broken; this is a workaround that may not resolve the root cause.",
      "fail_rate": 0.4,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Check if the docker-volume-local plugin is installed and enabled: 'docker plugin ls'. If missing, install it with 'docker plugin install --grant-all-permissions vieux/sshfs' or reinstall the Docker package that includes the local driver plugin.",
      "success_rate": 0.8,
      "how": "Check if the docker-volume-local plugin is installed and enabled: 'docker plugin ls'. If missing, install it with 'docker plugin install --grant-all-permissions vieux/sshfs' or reinstall the Docker package that includes the local driver plugin.",
      "condition": "",
      "sources": []
    },
    {
      "action": "On Windows with WSL2, ensure that the Docker Desktop WSL2 backend is properly configured: go to Settings > Resources > WSL Integration and enable integration for your WSL distro, then restart Docker Desktop.",
      "success_rate": 0.85,
      "how": "On Windows with WSL2, ensure that the Docker Desktop WSL2 backend is properly configured: go to Settings > Resources > WSL Integration and enable integration for your WSL distro, then restart Docker Desktop.",
      "condition": "",
      "sources": []
    },
    {
      "action": "If using a custom Docker root directory, verify that the volume plugin path is correctly set in /etc/docker/daemon.json with the 'volume-plugin' option, e.g., {\"volume-plugin\": \"/usr/lib/docker/plugins\"}.",
      "success_rate": 0.75,
      "how": "If using a custom Docker root directory, verify that the volume plugin path is correctly set in /etc/docker/daemon.json with the 'volume-plugin' option, e.g., {\"volume-plugin\": \"/usr/lib/docker/plugins\"}.",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "检查 docker-volume-local 插件是否已安装并启用：'docker plugin ls'。如果缺失，使用 'docker plugin install --grant-all-permissions vieux/sshfs' 安装，或重新安装包含 local 驱动插件的 Docker 包。",
    "在 Windows 上使用 WSL2 时，确保 Docker Desktop WSL2 后端配置正确：前往设置 > 资源 > WSL 集成，为你的 WSL 发行版启用集成，然后重启 Docker Desktop。",
    "如果使用自定义 Docker 根目录，请验证卷插件路径在 /etc/docker/daemon.json 中是否正确设置，例如 {\"volume-plugin\": \"/usr/lib/docker/plugins\"}。"
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://docs.docker.com/engine/extend/plugins/",
  "official_doc_section": null,
  "error_code": null,
  "verification_tier": "ai_generated",
  "confidence": 0.83,
  "fix_success_rate": 0.78,
  "resolvable": "partial",
  "first_seen": "2024-09-22",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}