podman-commit(1)            General Commands Manual           podman-commit(1)

NAME
       podman-commit - Create new image based on the changed container


SYNOPSIS
       podman commit [options] container [image]


       podman container commit [options] container [image]


DESCRIPTION
       podman commit creates an image based on a changed container. The author
       of the image can be set using the --author OPTION. Various image
       instructions can be configured with the --change OPTION and a commit
       message can be set using the --message OPTION. The container and its
       processes aren't paused while the image is committed. If this is not
       desired, the --pause OPTION can be set to true. When the commit is
       complete, Podman prints out the ID of the new image.


       If image does not begin with a registry name component, localhost is
       added to the name.  If image is not provided, the values for the
       REPOSITORY and TAG values of the created image is set to <none>.


OPTIONS
   --author, -a=author
       Set the author for the committed image.


   --change, -c=instruction
       Apply the following possible instructions to the created image:


              o CMD

              o ENTRYPOINT

              o ENV

              o EXPOSE

              o LABEL

              o ONBUILD

              o STOPSIGNAL

              o USER

              o VOLUME

              o WORKDIR



       Can be set multiple times.


   --config=ConfigBlobFile
       Merge the container configuration from the specified file into the
       configuration for the image as it is being committed. The file contents
       should be a JSON-encoded version of a Schema2Config structure, which is
       defined at
       https://github.com/containers/image/blob/v5.29.0/manifest/docker_schema2.go#L67.


   --format, -f=oci | docker
       Set the format of the image manifest and metadata.  The currently
       supported formats are oci and docker.
       The default is oci.


   --iidfile=ImageIDfile
       Write the image ID to the file.


   --include-volumes
       Include in the committed image any volumes added to the container by
       the --volume or --mount OPTIONS to the podman create and podman run
       commands.
       The default is false.


   --message, -m=message
       Set commit message for committed image.
       IMPORTANT: The message field is not supported in oci format.


   --pause, -p
       Pause the container when creating an image.
       The default is false.


   --quiet, -q
       Suppresses output.
       The default is false.


   --squash, -s
       Squash newly built layers into a single new layer.
       The default is false.


EXAMPLES
       Create image from container with entrypoint and label:

       $ podman commit --change CMD=/bin/bash --change ENTRYPOINT=/bin/sh --change "LABEL blue=image" reverent_golick image-committed
       Getting image source signatures
       Copying blob sha256:b41deda5a2feb1f03a5c1bb38c598cbc12c9ccd675f438edc6acd815f7585b86
        25.80 MB / 25.80 MB [======================================================] 0s
       Copying config sha256:c16a6d30f3782288ec4e7521c754acc29d37155629cb39149756f486dae2d4cd
        448 B / 448 B [============================================================] 0s
       Writing manifest to image destination
       Storing signatures
       e3ce4d93051ceea088d1c242624d659be32cf1667ef62f1d16d6b60193e2c7a8



       Create image from container with commit message:

       $ podman commit -q --message "committing container to image"
       reverent_golick image-committed
       e3ce4d93051ceea088d1c242624d659be32cf1667ef62f1d16d6b60193e2c7a8



       Create image from container with author:

       $ podman commit -q --author "firstName lastName" reverent_golick image-committed
       e3ce4d93051ceea088d1c242624d659be32cf1667ef62f1d16d6b60193e2c7a8



       Pause running container while creating image:

       $ podman commit -q --pause=true containerID image-committed
       e3ce4d93051ceea088d1c242624d659be32cf1667ef62f1d16d6b60193e2c7a8



       Create image from container with default image tag:

       $ podman commit containerID
       e3ce4d93051ceea088d1c242624d659be32cf1667ef62f1d16d6b60193e2c7a8



       Create image from container with default required capabilities:

       $ podman commit -q --change LABEL=io.containers.capabilities=setuid,setgid epic_nobel privimage
       400d31a3f36dca751435e80a0e16da4859beb51ff84670ce6bdc5edb30b94066



SEE ALSO
       podman(1), podman-run(1), podman-create(1)


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

                                                              podman-commit(1)