docker container create

Create a new container Docker CLI reference

100 options Also docker create Its page in the Docker CLI reference

Options

100 in the Docker CLI reference

Show its 100 options

--add-hostAdd a custom host-to-IP mapping (host:ip)

--annotationAdd an annotation to the container (passed through to the OCI runtime)

--attach, -aAttach to STDIN, STDOUT or STDERR

--blkio-weight-deviceBlock IO weight (relative device weight)

--blkio-weightBlock IO (relative weight), between 10 and 1000, or 0 to disable (default 0)

--cap-addAdd Linux capabilities

--cap-dropDrop Linux capabilities

--cgroup-parentOptional parent cgroup for the container

--cgroupnsCgroup namespace to use (host\

--cidfileWrite the container ID to the file

--cpu-countCPU count (Windows only)

--cpu-percentCPU percent (Windows only)

--cpu-periodLimit CPU CFS (Completely Fair Scheduler) period

--cpu-quotaLimit CPU CFS (Completely Fair Scheduler) quota

--cpu-rt-periodLimit CPU real-time period in microseconds

--cpu-rt-runtimeLimit CPU real-time runtime in microseconds

--cpu-shares, -cCPU shares (relative weight)

--cpusNumber of CPUs

--cpuset-cpusCPUs in which to allow execution (0-3, 0,1)

--cpuset-memsMEMs in which to allow execution (0-3, 0,1)

--device-cgroup-ruleAdd a rule to the cgroup allowed devices list

--device-read-bpsLimit read rate (bytes per second) from a device

--device-read-iopsLimit read rate (IO per second) from a device

--device-write-bpsLimit write rate (bytes per second) to a device

--device-write-iopsLimit write rate (IO per second) to a device

--deviceAdd a host device to the container

--dns-optionSet DNS options

--dns-searchSet custom DNS search domains

--dnsSet custom DNS servers

--domainnameContainer NIS domain name

--entrypointOverwrite the default ENTRYPOINT of the image

--env, -eSet environment variables

--env-fileRead in a file of environment variables

--exposeExpose a port or a range of ports

--gpusGPU devices to add to the container ('all' to pass all GPUs)

--group-addAdd additional groups to join

--health-cmdCommand to run to check health

--health-intervalTime between running the check (ms\

--health-retriesConsecutive failures needed to report unhealthy

--health-start-intervalTime between running the check during the start period (ms\

--health-start-periodStart period for the container to initialize before starting health-retries countdown (ms\

--health-timeoutMaximum time to allow one check to run (ms\

--helpPrint usage

--hostname, -hContainer host name

--initRun an init inside the container that forwards signals and reaps processes

--interactive, -iKeep STDIN open even if not attached

--io-maxbandwidthMaximum IO bandwidth limit for the system drive (Windows only)

--io-maxiopsMaximum IOps limit for the system drive (Windows only)

--ip6IPv6 address (e.g., 2001:db8::33)

--ipIPv4 address (e.g., 172.30.100.104)

--ipcIPC mode to use

--isolationContainer isolation technology

--label, -lSet meta data on a container

--label-fileRead in a line delimited file of labels

--link-local-ipContainer IPv4/IPv6 link-local addresses

--linkAdd link to another container

--log-driverLogging driver for the container

--log-optLog driver options

--mac-addressContainer MAC address (e.g., 92:d0:c6:0a:29:33)

--memory, -mMemory limit

--memory-reservationMemory soft limit

--memory-swapSwap limit equal to memory plus swap: '-1' to enable unlimited swap

--memory-swappinessTune container memory swappiness (0 to 100)

--mountAttach a filesystem mount to the container

--nameAssign a name to the container

--network-aliasAdd network-scoped alias for the container

--networkConnect a container to a network

--no-healthcheckDisable any container-specified HEALTHCHECK

--oom-kill-disableDisable OOM Killer

--oom-score-adjTune host's OOM preferences (-1000 to 1000)

--pidPID namespace to use

--pids-limitTune container pids limit (set -1 for unlimited)

--platformSet platform if server is multi-platform capable

--privilegedGive extended privileges to this container

--publish, -pPublish a container's port(s) to the host

--publish-all, -PPublish all exposed ports to random ports

--pullPull image before creating (always, missing, never)

--quiet, -qSuppress the pull output

--read-onlyMount the container's root filesystem as read only

--restartRestart policy to apply when a container exits

--rmAutomatically remove the container and its associated anonymous volumes when it exits

--runtimeRuntime to use for this container

--security-optSecurity Options

--shm-sizeSize of /dev/shm

--stop-signalSignal to stop the container

--stop-timeoutTimeout (in seconds) to stop a container

--storage-optStorage driver options for the container

--sysctlSysctl options

--tmpfsMount a tmpfs directory

--tty, -tAllocate a pseudo-TTY

--ulimitUlimit options

--umaskSet umask for the container

--use-api-socketBind mount Docker API socket and required auth

--user, -uUsername or UID (format: <name\

--usernsUser namespace to use

--utsUTS namespace to use

--volume, -vBind mount a volume

--volume-driverOptional volume driver for the container

--volumes-fromMount volumes from the specified container(s)

--workdir, -wWorking directory inside the container