Skip to content

Commit

Permalink
storage/index.md: state that bind mounts must use absolute paths
Browse files Browse the repository at this point in the history
Clarified that bind mounts *must* use absolute paths, else they will silently "fail" (have unexpected behavior).

References:
moby/moby#4830 (comment)
docker/cli#1203
  • Loading branch information
RobBednark committed Dec 20, 2020
1 parent 4a8f654 commit 6294235
Showing 1 changed file with 2 additions and 2 deletions.
4 changes: 2 additions & 2 deletions storage/index.md
Expand Up @@ -78,8 +78,8 @@ mounts is to think about where the data lives on the Docker host.
- **[Bind mounts](bind-mounts.md)**: Available since the early days of Docker.
Bind mounts have limited functionality compared to volumes. When you use a
bind mount, a file or directory on the _host machine_ is mounted into a
container. The file or directory is referenced by its full path on the host
machine. The file or directory does not need to exist on the Docker host
container. The file or directory must be referenced by its full path on the host
machine, or else it will silently fail. The file or directory does not need to exist on the Docker host
already. It is created on demand if it does not yet exist. Bind mounts are
very performant, but they rely on the host machine's filesystem having a
specific directory structure available. If you are developing new Docker
Expand Down

0 comments on commit 6294235

Please sign in to comment.