docker container create <container> <command>

Create a new container

Arguments

NameDescription
container
command

Options

NameDescription
--add-host <list>Add a custom host-to-IP mapping (host:ip)
-a, --attach <list>Attach to STDIN, STDOUT or STDERR
--blkio-weight <uint16>Block IO (relative weight), between 10 and 1000, or 0 to disable (default 0)
--blkio-weight-device <list>Block IO weight (relative device weight) (default [])
--cap-add <list>Add Linux capabilities
--cap-drop <list>Drop Linux capabilities
--cgroup-parent <string>Optional parent cgroup for the container
--cgroupns <string>Cgroup namespace to use (host|private)
--cidfile <string>Write the container ID to the file
--cpu-period <int>Limit CPU CFS (Completely Fair Scheduler) period
--cpu-quota <int>Limit CPU CFS (Completely Fair Scheduler) quota
--cpu-rt-period <int>Limit CPU real-time period in microseconds
--cpu-rt-runtime <int>Limit CPU real-time runtime in microseconds
-c, --cpu-shares <int>CPU shares (relative weight)
--cpus <decimal>Number of CPUs
--cpuset-cpus <string>CPUs in which to allow execution (0-3, 0,1)
--cpuset-mems <string>MEMs in which to allow execution (0-3, 0,1)
--device <list>Add a host device to the container
--device-cgroup-rule <list>Add a rule to the cgroup allowed devices list
--device-read-bps <list>Limit read rate (bytes per second) from a device (default [])
--device-read-iops <list>Limit read rate (IO per second) from a device (default [])
--device-write-bps <list>Limit write rate (bytes per second) to a device (default [])
--device-write-iops <list>Limit write rate (IO per second) to a device (default [])
--disable-content-trustSkip image verification (default true)
--dns <list>Set custom DNS servers
--dns-option <list>Set DNS options
--dns-search <list>Set custom DNS search domains
--domainname <string>Container NIS domain name
--entrypoint <string>Overwrite the default ENTRYPOINT of the image
-e, --env <list>Set environment variables
--env-file <list>Read in a file of environment variables
--expose <list>Expose a port or a range of ports
--gpus <gpu-request>GPU devices to add to the container ('all' to pass all GPUs)
--group-add <list>Add additional groups to join
--health-cmd <string>Command to run to check health
--health-interval <duration>Time between running the check (ms|s|m|h) (default 0s)
--health-retries <int>Consecutive failures needed to report unhealthy
--health-start-period <duration>Start period for the container to initialize before starting health-retries countdown (ms|s|m|h) (default 0s)
--health-timeout <duration>Maximum time to allow one check to run (ms|s|m|h) (default 0s)
--helpPrint usage
-h, --hostname <string>Container host name
--initRun an init inside the container that forwards signals and reaps processes
-i, --interactiveKeep STDIN open even if not attached
--ip <string>IPv4 address (e.g., 172.30.100.104)
--ip6 <string>IPv6 address (e.g., 2001:db8::33)
--ipc <string>IPC mode to use
--isolation <string>Container isolation technology
--kernel-memory <bytes>Kernel memory limit
-l, --label <list>Set meta data on a container
--label-file <list>Read in a line delimited file of labels
--link <list>Add link to another container
--link-local-ip <list>Container IPv4/IPv6 link-local addresses
--log-driver <string>Logging driver for the container
--log-opt <list>Log driver options
--mac-address <string>Container MAC address (e.g., 92:d0:c6:0a:29:33)
-m, --memory <bytes>Memory limit
--memory-reservation <bytes>Memory soft limit
--memory-swap <bytes>Swap limit equal to memory plus swap: '-1' to enable unlimited swap
--memory-swappiness <int>Tune container memory swappiness (0 to 100) (default -1)
--mount <mount>Attach a filesystem mount to the container
--name <string>Assign a name to the container
--network <network>Connect a container to a network
--network-alias <list>Add network-scoped alias for the container
--no-healthcheckDisable any container-specified HEALTHCHECK
--oom-kill-disableDisable OOM Killer
--oom-score-adj <int>Tune host's OOM preferences (-1000 to 1000)
--pid <string>PID namespace to use
--pids-limit <int>Tune container pids limit (set -1 for unlimited)
--platform <string>Set platform if server is multi-platform capable
--privilegedGive extended privileges to this container
-p, --publish <list>Publish a container's port(s) to the host
-P, --publish-allPublish all exposed ports to random ports
--pull <string>Pull image before creating ("always"|"missing"|"never") (default "missing")
--read-onlyMount the container's root filesystem as read only
--restart <string>Restart policy to apply when a container exits (default "no")
--rmAutomatically remove the container when it exits
--runtime <string>Runtime to use for this container
--security-opt <list>Security Options
--shm-size <bytes>Size of /dev/shm
--stop-signal <string>Signal to stop a container (default "SIGTERM")
--stop-timeout <int>Timeout (in seconds) to stop a container
--storage-opt <list>Storage driver options for the container
--sysctl <map>Sysctl options (default map[])
--tmpfs <list>Mount a tmpfs directory
-t, --ttyAllocate a pseudo-TTY
--ulimit <ulimit>Ulimit options (default [])
-u, --user <string>Username or UID (format: <name|uid>[:<group|gid>])
--userns <string>User namespace to use
--uts <string>UTS namespace to use
-v, --volume <list>Bind mount a volume
--volume-driver <string>Optional volume driver for the container
--volumes-from <list>Mount volumes from the specified container(s)
-w, --workdir <string>Working directory inside the container