docker config_error ai_generated partial

Error response from daemon: create volume: volume driver "local" is not supported on this platform

ID: docker/volume-driver-not-supported

Also available as: JSON · Markdown · 中文
78%Fix Rate
83%Confidence
1Evidence
2024-09-22First Seen

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
Docker Desktop 4.27.0 active — — —
Docker Engine 24.0.5 active — — —
Docker CE 25.0.1 active — — —

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.

generic

中文

Docker 安装缺少或配置了错误的 'local' 驱动卷插件，通常由于在非标准 Linux 发行版或具有 WSL2 问题的 Windows 上安装不完整。

Official Documentation

https://docs.docker.com/engine/extend/plugins/

Workarounds

  1. 80% success 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. 
    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.
  2. 85% success 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. 
    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.
  3. 75% success 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"}. 
    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"}.

中文步骤

  1. 检查 docker-volume-local 插件是否已安装并启用：'docker plugin ls'。如果缺失，使用 'docker plugin install --grant-all-permissions vieux/sshfs' 安装，或重新安装包含 local 驱动插件的 Docker 包。
  2. 在 Windows 上使用 WSL2 时，确保 Docker Desktop WSL2 后端配置正确：前往设置 > 资源 > WSL 集成，为你的 WSL 发行版启用集成，然后重启 Docker Desktop。
  3. 如果使用自定义 Docker 根目录，请验证卷插件路径在 /etc/docker/daemon.json 中是否正确设置，例如 {"volume-plugin": "/usr/lib/docker/plugins"}。

Dead Ends

Common approaches that don't work:

  1. 50% fail

    The issue is often a missing plugin configuration, not the Docker engine itself; reinstalling may not fix the plugin path or driver registration.

  2. 90% fail

    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.

  3. 40% fail

    Other drivers may also be unsupported if the plugin infrastructure is broken; this is a workaround that may not resolve the root cause.