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

# [NAME](#NAME)

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

# [SYNOPSIS](#SYNOPSIS)

**podman commit** \[*options*] *container* \[*image*]

**podman container commit** \[*options*] *container* \[*image*]

# [DESCRIPTION](#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](#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 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](#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](#SEE_ALSO)

[**podman(1)**](/man/enterprise-packages/podman-doc-5.8/podman.1), [**podman-run(1)**](/man/enterprise-packages/podman-doc-5.8/podman-run.1), [**podman-create(1)**](/man/enterprise-packages/podman-doc-5.8/podman-create.1)

## [Troubleshooting](#Troubleshooting)

See [podman-troubleshooting(7)](/man/enterprise-packages/podman-doc-5.8/podman-troubleshooting.7) for solutions to common issues.

# [HISTORY](#HISTORY)

December 2017, Originally compiled by Urvashi Mohnani umohnani@redhat.com ⟨mailto:umohnani@redhat.com⟩

---

Document: podman-container-commit(1) from podman-doc-5.8 5.8.9-r0 (Chainguard OS)
Source: https://github.com/containers/podman