---
title: "Create a new image from a container"
method: POST
path: "/commit"
tags: ["Image"]
---

# Create a new image from a container

`POST /commit`

## Query parameters

- `container` string
- `repo` string
- `tag` string
- `comment` string
- `author` string
- `pause` boolean
- `changes` string

## Request body

- ContainerConfig — Configuration for a container that is portable between hosts. When used as `ContainerConfig` field in an image, `ContainerConfig` is an optional field containing the configuration of the container that was last committed when creating the image. Previous versions of Docker builder used this field to store build cache, and it is not in active use anymore.
  - `Hostname` string — The hostname to use for the container, as a valid RFC 1123 hostname.
  - `Domainname` string — The domain name to use for the container.
  - `User` string — The user that commands are run as inside the container.
  - `AttachStdin` boolean — Whether to attach to `stdin`.
  - `AttachStdout` boolean — Whether to attach to `stdout`.
  - `AttachStderr` boolean — Whether to attach to `stderr`.
  - `ExposedPorts` object, nullable — An object mapping ports to an empty object in the form: `{"<port>/<tcp|udp|sctp>": {}}`
  - `Tty` boolean — Attach standard streams to a TTY, including `stdin` if it is not closed.
  - `OpenStdin` boolean — Open `stdin`
  - `StdinOnce` boolean — Close `stdin` after one attached client disconnects
  - `Env` string[] — A list of environment variables to set inside the container in the form `["VAR=value", ...]`. A variable without `=` is removed from the environment, rather than to have an empty value.
  - `Cmd` string[] — Command to run specified as a string or an array of strings.
  - `Healthcheck` HealthConfig — A test to perform to check that the container is healthy.
    - `Test` string[] — The test to perform. Possible values are: - `[]` inherit healthcheck from image or parent image - `["NONE"]` disable healthcheck - `["CMD", args...]` exec arguments directly - `["CMD-SHELL", command]` run command with system's default shell
    - `Interval` integer — The time to wait between checks in nanoseconds. It should be 0 or at least 1000000 (1 ms). 0 means inherit.
    - `Timeout` integer — The time to wait before considering the check to have hung. It should be 0 or at least 1000000 (1 ms). 0 means inherit.
    - `Retries` integer — The number of consecutive failures needed to consider a container as unhealthy. 0 means inherit.
    - `StartPeriod` integer — Start period for the container to initialize before starting health-retries countdown in nanoseconds. It should be 0 or at least 1000000 (1 ms). 0 means inherit.
  - `ArgsEscaped` boolean, nullable — Command is already escaped (Windows only)
  - `Image` string — The name (or reference) of the image to use when creating the container, or which was used when the container was created.
  - `Volumes` object — An object mapping mount point paths inside the container to empty objects.
  - `WorkingDir` string — The working directory for commands to run in.
  - `Entrypoint` string[] — The entry point for the container as a string or an array of strings. If the array consists of exactly one empty string (`[""]`) then the entry point is reset to system default (i.e., the entry point used by docker when there is no `ENTRYPOINT` instruction in the `Dockerfile`).
  - `NetworkDisabled` boolean, nullable — Disable networking for the container.
  - `MacAddress` string, nullable — MAC address of the container.
  - `OnBuild` string[], nullable — `ONBUILD` metadata that were defined in the image's `Dockerfile`.
  - `Labels` object — User-defined key/value metadata.
  - `StopSignal` string, nullable — Signal to stop a container as a string or unsigned integer.
  - `StopTimeout` integer, nullable — Timeout to stop a container in seconds.
  - `Shell` string[], nullable — Shell for when `RUN`, `CMD`, and `ENTRYPOINT` uses a shell.

## Response `201`

no error

- IdResponse — Response to an API call that returns just an Id
  - `Id` string, required — The id of the newly created object.

## Other responses

- `404` — no such container
- `500` — server error

---

[API](https://skmtc.net/aliyun/apis/docker-engine-api.md) · [All operations](https://skmtc.net/aliyun/apis/docker-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aliyun/docker-engine-api/versions/04bb09da9ccb/schema)