github.com/khulnasoft/cli@v0.0.0-20240402070845-01bcad7beefa/docs/reference/commandline/image_save.md (about)

     1  # save
     2  
     3  <!---MARKER_GEN_START-->
     4  Save one or more images to a tar archive (streamed to STDOUT by default)
     5  
     6  ### Aliases
     7  
     8  `docker image save`, `docker save`
     9  
    10  ### Options
    11  
    12  | Name             | Type     | Default | Description                        |
    13  |:-----------------|:---------|:--------|:-----------------------------------|
    14  | `-o`, `--output` | `string` |         | Write to a file, instead of STDOUT |
    15  
    16  
    17  <!---MARKER_GEN_END-->
    18  
    19  ## Description
    20  
    21  Produces a tarred repository to the standard output stream.
    22  Contains all parent layers, and all tags + versions, or specified `repo:tag`, for
    23  each argument provided.
    24  
    25  ## Examples
    26  
    27  ### Create a backup that can then be used with `docker load`.
    28  
    29  ```console
    30  $ docker save busybox > busybox.tar
    31  
    32  $ ls -sh busybox.tar
    33  
    34  2.7M busybox.tar
    35  
    36  $ docker save --output busybox.tar busybox
    37  
    38  $ ls -sh busybox.tar
    39  
    40  2.7M busybox.tar
    41  
    42  $ docker save -o fedora-all.tar fedora
    43  
    44  $ docker save -o fedora-latest.tar fedora:latest
    45  ```
    46  
    47  ### Save an image to a tar.gz file using gzip
    48  
    49  You can use gzip to save the image file and make the backup smaller.
    50  
    51  ```console
    52  $ docker save myimage:latest | gzip > myimage_latest.tar.gz
    53  ```
    54  
    55  ### Cherry-pick particular tags
    56  
    57  You can even cherry-pick particular tags of an image repository.
    58  
    59  ```console
    60  $ docker save -o ubuntu.tar ubuntu:lucid ubuntu:saucy
    61  ```