github.com/containers/podman/v2@v2.2.2-0.20210501105131-c1e07d070c4c/docs/source/markdown/podman-save.1.md (about)

     1  % podman-save(1)
     2  
     3  ## NAME
     4  podman\-save - Save image(s) to an archive
     5  
     6  ## SYNOPSIS
     7  **podman save** [*options*] *name*[:*tag*]
     8  
     9  **podman image save** [*options*] *name*[:*tag*]
    10  
    11  ## DESCRIPTION
    12  **podman save** saves an image to either **docker-archive**, **oci-archive**, **oci-dir** (directory with oci manifest type), or **docker-dir** (directory with v2s2 manifest type) on the local machine,
    13  default is **docker-archive**. **podman save** writes to STDOUT by default and can be redirected to a
    14  file using the **output** flag. The **quiet** flag suppresses the output when set.
    15  **podman save** will save parent layers of the image(s) and the image(s) can be loaded using **podman load**.
    16  To export the containers, use the **podman export**.
    17  Note: `:` is a restricted character and cannot be part of the file name.
    18  
    19  **podman [GLOBAL OPTIONS]**
    20  
    21  **podman save [GLOBAL OPTIONS]**
    22  
    23  **podman save [OPTIONS] NAME[:TAG]**
    24  
    25  ## OPTIONS
    26  
    27  #### **--compress**
    28  
    29  Compress tarball image layers when pushing to a directory using the 'dir' transport. (default is same compression type, compressed or uncompressed, as source)
    30  Note: This flag can only be set when using the **dir** transport i.e --format=oci-dir or --format-docker-dir
    31  
    32  #### **--output**, **-o**=*file*
    33  
    34  Write to a file, default is STDOUT
    35  
    36  #### **--format**=*format*
    37  
    38  Save image to **oci-archive, oci-dir** (directory with oci manifest type), or **docker-dir** (directory with v2s2 manifest type)
    39  ```
    40  --format oci-archive
    41  --format oci-dir
    42  --format docker-dir
    43  ```
    44  
    45  #### **--multi-image-archive**, **-m**
    46  
    47  Allow for creating archives with more than one image.  Additional names will be interpreted as images instead of tags.  Only supported for **docker-archive**.
    48  
    49  #### **--quiet**, **-q**
    50  
    51  Suppress the output
    52  
    53  #### **--help**, **-h**
    54  
    55  Print usage statement
    56  
    57  ## EXAMPLES
    58  
    59  ```
    60  $ podman save --quiet -o alpine.tar alpine:2.6
    61  ```
    62  
    63  ```
    64  $ podman save > alpine-all.tar alpine
    65  ```
    66  
    67  ```
    68  $ podman save -o oci-alpine.tar --format oci-archive alpine
    69  ```
    70  
    71  ```
    72  $ podman save --compress --format oci-dir -o alp-dir alpine
    73  Getting image source signatures
    74  Copying blob sha256:2fdfe1cd78c20d05774f0919be19bc1a3e4729bce219968e4188e7e0f1af679d
    75   1.97 MB / 1.97 MB [========================================================] 0s
    76  Copying config sha256:501d1a8f0487e93128df34ea349795bc324d5e0c0d5112e08386a9dfaff620be
    77   584 B / 584 B [============================================================] 0s
    78  Writing manifest to image destination
    79  Storing signatures
    80  ```
    81  
    82  ```
    83  $ podman save --format docker-dir -o ubuntu-dir ubuntu
    84  Getting image source signatures
    85  Copying blob sha256:660c48dd555dcbfdfe19c80a30f557ac57a15f595250e67bfad1e5663c1725bb
    86   45.55 MB / 45.55 MB [======================================================] 8s
    87  Copying blob sha256:4c7380416e7816a5ab1f840482c9c3ca8de58c6f3ee7f95e55ad299abbfe599f
    88   846 B / 846 B [============================================================] 0s
    89  Copying blob sha256:421e436b5f80d876128b74139531693be9b4e59e4f1081c9a3c379c95094e375
    90   620 B / 620 B [============================================================] 0s
    91  Copying blob sha256:e4ce6c3651b3a090bb43688f512f687ea6e3e533132bcbc4a83fb97e7046cea3
    92   849 B / 849 B [============================================================] 0s
    93  Copying blob sha256:be588e74bd348ce48bb7161350f4b9d783c331f37a853a80b0b4abc0a33c569e
    94   169 B / 169 B [============================================================] 0s
    95  Copying config sha256:20c44cd7596ff4807aef84273c99588d22749e2a7e15a7545ac96347baa65eda
    96   3.53 KB / 3.53 KB [========================================================] 0s
    97  Writing manifest to image destination
    98  Storing signatures
    99  ```
   100  
   101  ## SEE ALSO
   102  podman(1), podman-load(1)
   103  
   104  ## HISTORY
   105  July 2017, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>