VOLUME instruction and
-v dest are used to create unnamed/anonymous volumes,
-v scr:dest option is for mapped volume.
VOLUME does not allow you to specify a host path.
On the host-side, the volumes are created with a very long ID-like name, these volumes are often referred to as unnamed/anonymous volumes.
Given this Dockerfile:
docker build -t myTest
Run it :
docker run --rm -it myTest
Inside the container, run
ls and you'll notice the directory exists;
Running the container also creates a directory on the host-side.
While having the container running, execute
docker volume ls on the host machine and you'll see something like this
DRIVER VOLUME NAME
Back in the container, execute
This file is now available on the host machine, in one of the unnamed volumes.
Similarly, you can try to delete this file on the host and it will be deleted in the container as well.
Now run a new container, but specify a volume using
docker run --rm -it -v /myVolume myTest
This adds a second volume and the whole system ends up having two unnamed volumes.
On the host-side, the new second volume is anonymous and resides together with the other volume in
It was stated earlier that the
Dockerfile can not map to a host path which sort of pose a problem for us when trying to bring files in from the host to the container during runtime. A different
-v syntax solves this problem.
Imagine I have a subfolder in my project directory
./src that I wish to sync to
/src inside the container. This command does the trick:
docker run -it -v $(pwd)/src:/src myTest
Both sides of the
: character expects an absolute path. Left side being an absolute path on the host machine, right side being an absolute path inside the container.
We run this command:
docker run -v $(pwd)/src:/src myTest
Is the specification purely informational?
No, it does mount a volume, it's similar to
-v /var/www you just don't specify a mount point in the host machine, so docker will take care of it.
What are the (dis)advantages of (not) specifying volumes?
Why and in which cases should I use VOLUME and when shouldn't I?
It's probably a best practice to never use
The first reason we have already identified: We can not specify the host path.
The second reason is people might forget to use the
--rm option when running the container, you will end up with a couple of unused volumes and it might be a daunting task to figure out which of all anonymous volumes are safe to remove
What about files that may optionally be mounted? Do they count as volumes in that case, too?
In this case you don't need volumes; mapping a single file does not make sense, I would use
COPY inside the dockerfile.