docker-create(1)



DOCKER(1)                                                            DOCKER(1)

NAME
       docker-create - Create a new container

SYNOPSIS
       docker create [OPTIONS] IMAGE [COMMAND] [ARG...]

DESCRIPTION
       Alias for docker container create.

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)

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

       --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(1)

Docker Community                   Jun 2020                          DOCKER(1)

Man(1) output converted with man2html
list of all man pages