# ContainerConfig


[API catalog](/reference/api/) · [Docker Engine overview](/reference/api/engine/version/v1.57/) · [Product manual](https://docs.docker.com/engine/) · [OpenAPI specification](/reference/api/engine/version/v1.57.yaml)

API version: 1.57





Schema constraints and annotations:

```json
{
  "description": "Configuration for a container that is portable between hosts.\n",
  "properties": {
    "ArgsEscaped": {
      "default": false,
      "description": "Command is already escaped (Windows only)",
      "example": false,
      "type": "boolean",
      "x-nullable": true
    },
    "AttachStderr": {
      "default": true,
      "description": "Whether to attach to `stderr`.",
      "type": "boolean"
    },
    "AttachStdin": {
      "default": false,
      "description": "Whether to attach to `stdin`.",
      "type": "boolean"
    },
    "AttachStdout": {
      "default": true,
      "description": "Whether to attach to `stdout`.",
      "type": "boolean"
    },
    "Cmd": {
      "description": "Command to run specified as a string or an array of strings.\n",
      "example": [
        "/bin/sh"
      ],
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "Domainname": {
      "description": "The domain name to use for the container.\n",
      "type": "string"
    },
    "Entrypoint": {
      "description": "The entry point for the container as a string or an array of strings.\n\nIf the array consists of exactly one empty string (`[\"\"]`) then the\nentry point is reset to system default (i.e., the entry point used by\ndocker when there is no `ENTRYPOINT` instruction in the `Dockerfile`).\n",
      "example": [],
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "Env": {
      "description": "A list of environment variables to set inside the container in the\nform `[\"VAR=value\", ...]`. A variable without `=` is removed from the\nenvironment, rather than to have an empty value.\n",
      "example": [
        "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
      ],
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "ExposedPorts": {
      "additionalProperties": {
        "default": {},
        "enum": [
          {}
        ],
        "type": "object"
      },
      "description": "An object mapping ports to an empty object in the form:\n\n`{\"\u003cport\u003e/\u003ctcp|udp|sctp\u003e\": {}}`\n",
      "example": {
        "443/tcp": {},
        "80/tcp": {}
      },
      "type": "object",
      "x-nullable": true
    },
    "Healthcheck": {
      "$ref": "#/components/schemas/HealthConfig"
    },
    "Hostname": {
      "description": "The hostname to use for the container, as a valid RFC 1123 hostname.\n",
      "example": "439f4e91bd1d",
      "type": "string"
    },
    "Image": {
      "description": "The name (or reference) of the image to use when creating the container,\nor which was used when the container was created.\n",
      "example": "example-image:1.0",
      "type": "string"
    },
    "Labels": {
      "additionalProperties": {
        "type": "string"
      },
      "description": "User-defined key/value metadata.",
      "example": {
        "com.example.some-label": "some-value",
        "com.example.some-other-label": "some-other-value"
      },
      "type": "object"
    },
    "NetworkDisabled": {
      "description": "Disable networking for the container.",
      "type": "boolean",
      "x-nullable": true
    },
    "OnBuild": {
      "description": "`ONBUILD` metadata that were defined in the image's `Dockerfile`.\n",
      "example": [],
      "items": {
        "type": "string"
      },
      "type": "array",
      "x-nullable": true
    },
    "OpenStdin": {
      "default": false,
      "description": "Open `stdin`",
      "type": "boolean"
    },
    "Shell": {
      "description": "Shell for when `RUN`, `CMD`, and `ENTRYPOINT` uses a shell.\n",
      "example": [
        "/bin/sh",
        "-c"
      ],
      "items": {
        "type": "string"
      },
      "type": "array",
      "x-nullable": true
    },
    "StdinOnce": {
      "default": false,
      "description": "Close `stdin` after one attached client disconnects",
      "type": "boolean"
    },
    "StopSignal": {
      "description": "Signal to stop a container as a string or unsigned integer.\n",
      "example": "SIGTERM",
      "type": "string",
      "x-nullable": true
    },
    "StopTimeout": {
      "description": "Timeout to stop a container in seconds. If omitted, the daemon-wide\ndefault (`default-stop-timeout`) is used.\n",
      "type": "integer",
      "x-nullable": true
    },
    "Tty": {
      "default": false,
      "description": "Attach standard streams to a TTY, including `stdin` if it is not closed.\n",
      "type": "boolean"
    },
    "User": {
      "description": "Commands run as this user inside the container. If omitted, commands\nrun as the user specified in the image the container was started from.\n\nCan be either user-name or UID, and optional group-name or GID,\nseparated by a colon (`\u003cuser-name|UID\u003e[\u003c:group-name|GID\u003e]`).",
      "example": "123:456",
      "type": "string"
    },
    "Volumes": {
      "additionalProperties": {
        "default": {},
        "enum": [
          {}
        ],
        "type": "object"
      },
      "description": "An object mapping mount point paths inside the container to empty\nobjects.\n",
      "type": "object"
    },
    "WorkingDir": {
      "description": "The working directory for commands to run in.",
      "example": "/public/",
      "type": "string"
    }
  },
  "type": "object"
}
```



