DOCKER(1)DOCKER(1)
NAME
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
--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
--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: <name|uid>[:<group|gid>])
--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)
Docker Community Jun 2020 DOCKER(1)