NAME

       docker-container-run - Create and run a new container from an image

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)

       --annotation=map[]       Add  an  annotation  to  the container (passed through to the OCI
       runtime)

       -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")

       -q, --quiet[=false]      Suppress the pull output

       --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=""      Signal to stop the 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)