---
name: "docker-container-commit"
section: "1"
platform: "linux"
package: "docker"
version: "1:29.9.2-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/docker-container-commit"
---

# docker-container-commit(1)

Create a new image from a container's changes

## NAME

docker-container-commit - Create a new image from a container's changes

## SYNOPSIS

**docker container commit \[OPTIONS\] CONTAINER \[REPOSITORY\[:TAG\]\]**

## DESCRIPTION

Create a new image from an existing container specified by name or container ID.  The new image will contain the contents of the container filesystem, *excluding* any data volumes. Refer to **[docker-tag(1)](/docker-tag/1.md)** for more information about valid image and tag names.

While the **docker commit** command is a convenient way of extending an existing image, you should prefer the use of a Dockerfile and **docker** **build** for generating images that you intend to share with other people.

## EXAMPLES

## Creating a new image from an existing container

An existing Fedora based container has had Apache installed while running in interactive mode with the bash shell. Apache is also running. To create a new image run **docker ps** to find the container's ID and then run:

```
$ docker commit -m="Added Apache to Fedora base image" \
  -a="A D Ministrator" 98bd7fc99854 fedora/fedora_httpd:20
```

Note that only a-z0-9-\_. are allowed when naming images from an existing container.

## Apply specified Dockerfile instructions while committing the image

If an existing container was created without the DEBUG environment variable set to "true", you can create a new image based on that container by first getting the container's ID with **docker ps** and then running:

```
$ docker container commit -c="ENV DEBUG=true" 98bd7fc99854 debug-image
```

## OPTIONS

**-a**, **--author**=""\
 	Author (e.g., "John Hannibal Smith hannibal@a-team.com ⟨mailto:hannibal@a-team.com⟩")

**-c**, **--change**=\
 	Apply Dockerfile instruction to the created image

**-m**, **--message**=""\
 	Commit message

**--no-pause**\[=false\]\
 	Disable pausing container during commit

## SEE ALSO

**[docker-container(1)](/docker-container/1.md)**