Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
podman-save(1)		    General Commands Manual		podman-save(1)

NAME
       podman-save - Save image(s) to an archive

SYNOPSIS
       podman save [options] name[:tag]

       podman image save [options] name[:tag]

DESCRIPTION
       podman  save  saves an image to a local file or directory.  podman save
       writes to STDOUT	by default and can be redirected to a file  using  the
       output  flag.  The  quiet  flag suppresses the output when set.	podman
       save saves parent layers	of the image(s)	and the	image(s) can be	loaded
       using podman load.  To export the containers, use  the  podman  export.
       Note: : is a restricted character and cannot be part of the file	name.

       podman [GLOBAL OPTIONS]

       podman save [GLOBAL OPTIONS]

       podman save [OPTIONS] NAME[:TAG]

OPTIONS
   --compress
       Compress	 tarball  image	 layers	 when pushing to a directory using the
       'dir' transport.	(default is same compression type, compressed  or  un-
       compressed, as source)

       Note: This flag can only	be set with --format=docker-dir.

   --format=format
       An image	format to produce, one of:

       +----------------+----------------------------------------------------------------------+
       | Format		| Description							       |
       +----------------+----------------------------------------------------------------------+
       | docker-archive	| A tar	archive	interoperable with docker load(1) (the default)	       |
       +----------------+----------------------------------------------------------------------+
       | oci-archive	| A tar	archive	using the OCI Image Format			       |
       +----------------+----------------------------------------------------------------------+
       | oci-dir	| A directory using the	OCI Image Format			       |
       +----------------+----------------------------------------------------------------------+
       | docker-dir	| dir transport	(see containers-transports(5)) with v2s2 manifest type |
       +----------------+----------------------------------------------------------------------+

   --help, -h
       Print usage statement

   --multi-image-archive, -m
       Allow for creating archives with	more than one image.  Additional names
       are  interpreted	 as images instead of tags.  Only supported for	--for-
       mat=docker-archive.  The	default	for this option	can  be	 modified  via
       the multi_image_archive="true"|"false" flag in containers.conf.

   --output, -o=file
       Write to	a file,	default	is STDOUT

   --quiet, -q
       Suppress	the output

   --uncompressed
       Accept uncompressed layers when using one of the	OCI formats.

EXAMPLES
       Save image to a local file without displaying progress.

       $ podman	save --quiet -o	alpine.tar alpine:2.6

       Save image to stdout and	redirect content via shell.

       $ podman	save alpine > alpine-all.tar

       Save image in oci-archive format	to the local file.

       $ podman	save -o	oci-alpine.tar --format	oci-archive alpine

       Save image compressed in	docker-dir format.

       $ podman	save --compress	--format docker-dir -o alp-dir alpine
       Getting image source signatures
       Copying blob sha256:2fdfe1cd78c20d05774f0919be19bc1a3e4729bce219968e4188e7e0f1af679d
	1.97 MB	/ 1.97 MB [========================================================] 0s
       Copying config sha256:501d1a8f0487e93128df34ea349795bc324d5e0c0d5112e08386a9dfaff620be
	584 B /	584 B [============================================================] 0s
       Writing manifest	to image destination
       Storing signatures

SEE ALSO
       podman(1), podman-load(1), containers.conf(5), containers-transports(5)

HISTORY
       July  2017,  Originally compiled	by Urvashi Mohnani umohnani@redhat.com
       <mailto:umohnani@redhat.com>

								podman-save(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=podman-image-save&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help