docker-container-run – Run a command in a new container
Synopsis
docker container run [OPTIONS] IMAGE [COMMAND] [ARG…]
Description
Alias for docker run.
Options
–add-host=
Add a custom host-to-IP mapping (host:ip)
-a, –attach= Attach to STDIN, STDOUT or STDERR
–blkio-weight=0 Block IO (relative weight), between 10 and 1000, or 0 to disable (default 0)
–blkio-weight-device=[] Block IO weight (relative device weight)
–cap-add= Add Linux capabilities
–cap-drop= Drop Linux capabilities
–cgroup-parent="" Optional parent cgroup for the container
–cgroupns="" Cgroup namespace to use (host|private)
default-cgroupns-mode option on the daemon (default)
–cidfile="" Write the container ID to the file
–cpu-count=0 CPU count (Windows only)
–cpu-percent=0 CPU percent (Windows only)
–cpu-period=0 Limit CPU CFS (Completely Fair Scheduler) period
–cpu-quota=0 Limit CPU CFS (Completely Fair Scheduler) quota
–cpu-rt-period=0 Limit CPU real-time period in microseconds
–cpu-rt-runtime=0 Limit CPU real-time runtime in microseconds
-c, –cpu-shares=0 CPU shares (relative weight)
–cpus= Number of CPUs
–cpuset-cpus="" CPUs in which to allow execution (0-3, 0,1)
–cpuset-mems="" MEMs in which to allow execution (0-3, 0,1)
-d, –detach[=false] Run container in background and print container ID
–detach-keys="" Override the key sequence for detaching a container
–device= Add a host device to the container
–device-cgroup-rule= Add a rule to the cgroup allowed devices list
–device-read-bps=[] Limit read rate (bytes per second) from a device
–device-read-iops=[] Limit read rate (IO per second) from a device
–device-write-bps=[] Limit write rate (bytes per second) to a device
–device-write-iops=[] Limit write rate (IO per second) to a device
–disable-content-trust[=true] Skip image verification
–dns= Set custom DNS servers
–dns-option= Set DNS options
–dns-search= Set custom DNS search domains
–domainname="" Container NIS domain name
–entrypoint="" Overwrite the default ENTRYPOINT of the image
-e, –env= Set environment variables
–env-file= Read in a file of environment variables
–expose= Expose a port or a range of ports
–gpus= GPU devices to add to the container (‘all’ to pass all GPUs)
–group-add= Add additional groups to join
–health-cmd="" Command to run to check health
–health-interval=0s Time between running the check (ms|s|m|h) (default 0s)
–health-retries=0 Consecutive failures needed to report unhealthy
–health-start-period=0s Start period for the container to initialize before starting health-retries countdown (ms|s|m|h) (default 0s)
–health-timeout=0s Maximum time to allow one check to run (ms|s|m|h) (default 0s)
–help[=false] Print usage
-h, –hostname="" Container host name
–init[=false] Run an init inside the container that forwards signals and reaps processes
-i, –interactive[=false] Keep STDIN open even if not attached
–io-maxbandwidth=0 Maximum IO bandwidth limit for the system drive (Windows only)
–io-maxiops=0 Maximum IOps limit for the system drive (Windows only)
–ip="" IPv4 address (e.g., 172.30.100.104)
–ip6="" IPv6 address (e.g., 2001:db8::33)
–ipc="" IPC mode to use
–isolation="" Container isolation technology
–kernel-memory=0 Kernel memory limit
-l, –label= Set meta data on a container
–label-file= Read in a line delimited file of labels
–link= Add link to another container
–link-local-ip= Container IPv4/IPv6 link-local addresses
–log-driver="" Logging driver for the container
–log-opt= Log driver options
–mac-address="" Container MAC address (e.g., 92:d0:c6:0a:29:33)
-m, –memory=0 Memory limit
–memory-reservation=0 Memory soft limit
–memory-swap=0 Swap limit equal to memory plus swap: ‘-1’ to enable unlimited swap
–memory-swappiness=-1 Tune container memory swappiness (0 to 100)
–mount= Attach a filesystem mount to the container
–name="" Assign a name to the container
–network= Connect a container to a network
–network-alias= Add network-scoped alias for the container
–no-healthcheck[=false] Disable any container-specified HEALTHCHECK
–oom-kill-disable[=false] Disable OOM Killer
–oom-score-adj=0 Tune host’s OOM preferences (-1000 to 1000)
–pid="" PID namespace to use
–pids-limit=0 Tune container pids limit (set -1 for unlimited)
–platform="" Set platform if server is multi-platform capable
–privileged[=false] Give extended privileges to this container
-p, –publish= Publish a container’s port(s) to the host
-P, –publish-all[=false] Publish all exposed ports to random ports
–pull="missing" Pull image before running ("always"|"missing"|"never")
–read-only[=false] Mount the container’s root filesystem as read only
–restart="no" Restart policy to apply when a container exits
–rm[=false] Automatically remove the container when it exits
–runtime="" Runtime to use for this container
–security-opt= Security Options
–shm-size=0 Size of /dev/shm
–sig-proxy[=true] Proxy received signals to the process
–stop-signal="SIGTERM" Signal to stop a container
–stop-timeout=0 Timeout (in seconds) to stop a container
–storage-opt= Storage driver options for the container
–sysctl=map[] Sysctl options
–tmpfs= Mount a tmpfs directory
-t, –tty[=false] Allocate a pseudo-TTY
–ulimit=[] Ulimit options
-u, –user="" Username or UID (format: [:])
–userns="" User namespace to use
–uts="" UTS namespace to use
-v, –volume= Bind mount a volume
–volume-driver="" Optional volume driver for the container
–volumes-from= Mount volumes from the specified container(s)
-w, –workdir="" Working directory inside the container
See Also
docker-container(1)
