Skip to main content
Saves an image to a tar archive on disk. Useful for exporting images for offline transport.

​
Usage

container image save [--arch <arch>] [--os <os>] --output <output> [--platform <platform>] [--debug] <references> ...

​
Arguments

​
references
string
required
Image references to save

​
Options

​
-a, --arch
string
Architecture for the saved image
​
--os
string
OS for the saved image
​
-o, --output
string
required
Pathname for the saved image
​
--platform
string
Platform for the saved image (format: os/arch[/variant], takes precedence over —os and —arch)
​
--debug
boolean
Enable debug output

​
Examples

# Save an image to a tar file
container image save --output my-app.tar my-app:latest

# Save a specific platform variant
container image save --platform linux/amd64 --output my-app-amd64.tar my-app:latest

# Save multiple images to one archive
container image save --output images.tar nginx:latest alpine:latest
Saved images can be loaded on another system using container image load.

Build docs developers (and LLMs) love

Get started for freeTalk to us