error while mounting volume: failed to mount local volume: mount: no such file or directory
Fixes 'error while mounting volume ... no such file or directory' when a volume's host device or path is missing. Use when docker volume create with device options, or startup, fails on the mount. Not for bind source missing (simpler case).
TL;DR: The device or host path backing the volume does not exist. Verify it with lsblk / ls, fix the device name or create the path, then retry. This hits people using the local driver's device option for disk-backed volumes, where a renamed disk (sdb became sdc) breaks every mount.
The error
error while mounting volume '/var/lib/docker/volumes/myvol/_data': failed to mount local volume: mount /dev/sdb1:/var/lib/docker/volumes/myvol/_data URIs no such file or directoryFix it
- Check the device exists:
lsblk | grep sdb1 Expected: either present (path problem) or absent (device renamed/missing).
- If the disk moved (common after reboot with multiple USB/SATA disks), find its new name and update the volume options, or better, switch the volume to UUID-based device paths.
- If it is a plain path, create it:
sudo mkdir -p /mnt/voldata
- Retry the container start.
When this applies
docker volume create --opt device=/dev/...volumes- Daemon/volume plugin startup failures referencing missing paths
When this does NOT apply
- Simple bind mounts (the 'bind source path does not exist' skill)
- Permission errors on existing paths
Versions
All Docker versions; local volume driver options are stable.
Why it happens
The local volume driver performs a real mount syscall with your options. Unlike -v binds, there is no auto-creation; a wrong device node or missing directory fails the mount and the container never starts.
Edge cases
- Use /dev/disk/by-uuid/... instead of /dev/sdX in volume options; sd letters are not stable across reboots.
- NFS-backed volumes (
--opt type=nfs) fail this way when the server is unreachable; checkshowmount -e [server]. - After fixing,
docker volume inspect myvolshows the stored options; recreate the volume if the options themselves are wrong (options are immutable).
Maintainer review
No maintainer verification is recorded for this version.
This records the version a maintainer checked. It does not assert that the version is the latest upstream release.