When building Docker images, there are scenarios where you need to copy files from a Docker container to the host machine's external enviroment. This is commonly required for extracting data, configuraton files, or other artifacts produced inside a container. This article explains how to copy files from a Docker container to the host system, with practical code examples.

Understanding File Copying in Docker

Docker containers run as isolated environments that encapsulate applications and their dependencies. While the docker cp command allows you to copy files between the host and a container, copying files from a container to the host's external environment often requires additional steps, especially if you want the files to persist outside of the container lifecycle.

Using Volume Mounting

A reliable approach is to use volume mounts. When running a container, bind mount a host directory to a directory inside the container using the -v flag. Files saved by the container into the mounted directory will appear on the host. You can then access or move them from the host as needed.

Example: Copying a Log File

Below is a step-by-step example demonstrating how to copy a file from a container to the host via a volume mount.

# Create a host directory for mounting
mkdir /host_dir

# Run a Docker container, mounting the host directory into /container_dir
docker run -v /host_dir:/container_dir -d your_image

# Inside the container, copy the target file to the mounted directory
docker exec -it container_id cp /var/log/file.log /container_dir

After these steps, file.log becomes available at /host_dir on the host machine.

Complete Demo

Let's walk through a complete example. Suppose we have a container containing a file named data.txt that we want to export to the host.

1. Prepare a Docker Image

Create a simple Dockerfile that includes data.txt:

FROM alpine:latest
COPY data.txt /data.txt

2. Build and Run the Container

docker build -t data_image .
docker run -d data_image

3. Copy the File Using a Volume Mount

mkdir /host_data
docker run -v /host_data:/data -d data_image
docker exec -it container_id cp /data.txt /data

Now data.txt resides in /host_data on the host, successfully extracted from the container.

Summary

This article demonstrated how to copy files from a Docker container to the host system by leveraging volume mounts. This technique is useful for retrieving data, logs, configurations, or any files generated inside containers. By mounting a host directory into the container, files saved to that directory become accessible on the host, simplifying export workflows.

References

1. Docker Documentation
2. Docker: Copying files from a container to host
3. Docker Volumes