tar archives, move them into air-gapped or restricted environments, and load or import them back into Docker without direct internet access.
Table of Contents
- Exporting and Transferring Docker Images
- Exporting a Container Filesystem and Importing as an Image
- Docker CLI Reference
- Links and References
1. Exporting and Transferring Docker Images
When you cannot pull directly from Docker Hub (for example, in a restricted environment), follow these steps:Step-by-Step Guide
- Pull the desired image on an internet-connected host:
- Save the image into a tarball:
- Transfer
alpine.tarto the target system (USB drive, SCP, shared NFS, etc.). - Load the tarball on the restricted host:
You should see output similar to:
- Confirm the image is available locally:
Example output:
Always verify you’re using the correct
<repository>:<tag> when saving and loading images to avoid version mismatches.Ensure you have sufficient disk space on both source and target systems before exporting large images.
2. Exporting a Container Filesystem and Importing as an Image
You can snapshot a running container’s filesystem and convert it into a new Docker image:- Export the container to a tar archive:
- Import the tarball as a fresh image:
Docker returns a new image ID, e.g.:
- List local images to confirm the import:
Example output: