How to mount a host directory in a Docker container

Mounting host directories into containers in Docker is a common practice. This enables containers to access and modify files on the host while preserving data even after the container is restarted or deleted. Mounting directories is typically achieved using the -v or --mount flags. Below, I will provide a detailed explanation and a specific example.

Using -v or --volume Flag

The -v or --volume flag allows you to mount a host directory into a container when running it. The syntax is as follows:

bash
docker run -v [host directory]:[container directory] [other parameters] [image name]

Example:

Suppose you have an application that needs to access the host's /data/myappdata directory during runtime, and you want this directory mapped to /app/data in the container. You can use the following command:

bash
docker run -v /data/myappdata:/app/data -d myappimage

This command starts a container based on the myappimage image, synchronizing the container's /app/data directory with the host's /data/myappdata directory.

Using --mount Flag

Although the -v parameter is straightforward, Docker officially recommends using the more modern --mount flag for its clearer syntax and richer functionality. The syntax is as follows:

bash
docker run --mount type=bind,source=[host directory],target=[container directory] [other parameters] [image name]

Example:

Continuing with the previous example, if you want to achieve the same mounting effect using --mount, you can use the following command:

bash
docker run --mount type=bind,source=/data/myappdata,target=/app/data -d myappimage

This command also starts a container based on the myappimage image, mounting the host's /data/myappdata directory to the container's /app/data directory.

Notes

• Ensure the host directory you are mounting exists on the host; otherwise, Docker may automatically create an empty directory for you.
• Read and write operations on the mounted directory by the container may be restricted by the host's filesystem permissions.
• The application inside the container must have the correct permissions to access the mounted directory.

Through the above explanation and examples, you should now understand how to mount host directories in Docker containers. This is a highly practical feature that effectively addresses data persistence and sharing challenges.