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 in-
structions can be configured with the --change OPTION and a commit mes-
sage can be set using the --message OPTION. The container and its
processes aren't paused while the image is committed. If this is not de-
sired, the --pause OPTION can be set to true. When the commit is com-
plete, 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 REPOSI-
TORY 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:
• CMD
• ENTRYPOINT
• ENV
• EXPOSE
• LABEL
• ONBUILD
• STOPSIGNAL
• USER
• VOLUME
• WORKDIR
Can be set multiple times.
--config=ConfigBlobFile
Merge the container configuration from the specified file into the con-
figuration 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/mani-
fest/docker_schema2.go#L67.
--format, -f=oci | docker
Set the format of the image manifest and metadata. The currently sup-
ported 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 com-
mands.
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)
Troubleshooting
See podman-troubleshooting(7) for solutions to common issues.
HISTORY
December 2017, Originally compiled by Urvashi Mohnani umohnani@red-
hat.com ⟨mailto:umohnani@redhat.com⟩
podman-commit(1)
Generated by dwww version 1.16 on Tue Dec 16 06:01:02 CET 2025.