---
name: "docker-image-save"
section: "1"
platform: "linux"
package: "docker"
version: "1:29.9.2-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/docker-image-save"
---

# docker-image-save(1)

Save one or more images to a tar archive (streamed to STDOUT by default)

## NAME

docker-image-save - Save one or more images to a tar archive (streamed to STDOUT by default)

## SYNOPSIS

**docker image save \[OPTIONS\] IMAGE \[IMAGE...\]**

## DESCRIPTION

Produces a tarred repository to the standard output stream. Contains all parent layers, and all tags + versions, or specified repo:tag.

Stream to a file instead of STDOUT by using **-o**.

## EXAMPLES

Save all fedora repository images to a fedora-all.tar and save the latest fedora image to a fedora-latest.tar:

```
$ docker image save fedora > fedora-all.tar
$ docker image save --output=fedora-latest.tar fedora:latest
$ ls -sh fedora-all.tar
721M fedora-all.tar
$ ls -sh fedora-latest.tar
367M fedora-latest.tar
```

## See also

**[docker-image-load(1)](/docker-image-load/1.md)** to load an image from a tar archive on STDIN.

## OPTIONS

**-o**, **--output**=""\
 	Write to a file, instead of STDOUT

**--platform**=\[\]\
 	Save only the given platform(s). Formatted as a comma-separated list of "os\[/arch\[/variant\]\]" (e.g., "linux/amd64,linux/arm64/v8")

## SEE ALSO

**[docker-image(1)](/docker-image/1.md)**