run.rst 1.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940
  1. :title: Run Command
  2. :description: Run a command in a new container
  3. :keywords: run, container, docker, documentation
  4. ===========================================
  5. ``run`` -- Run a command in a new container
  6. ===========================================
  7. ::
  8. Usage: docker run [OPTIONS] IMAGE [COMMAND] [ARG...]
  9. Run a command in a new container
  10. -a=map[]: Attach to stdin, stdout or stderr.
  11. -c=0: CPU shares (relative weight)
  12. -cidfile="": Write the container ID to the file
  13. -d=false: Detached mode: Run container in the background, print new container id
  14. -e=[]: Set environment variables
  15. -h="": Container host name
  16. -i=false: Keep stdin open even if not attached
  17. -m=0: Memory limit (in bytes)
  18. -n=true: Enable networking for this container
  19. -p=[]: Map a network port to the container
  20. -t=false: Allocate a pseudo-tty
  21. -u="": Username or UID
  22. -d=[]: Set custom dns servers for the container
  23. -v=[]: Create a bind mount with: [host-dir]:[container-dir]:[rw|ro]. If "host-dir" is missing, then docker creates a new volume.
  24. -volumes-from="": Mount all volumes from the given container.
  25. -entrypoint="": Overwrite the default entrypoint set by the image.
  26. Examples
  27. --------
  28. .. code-block:: bash
  29. docker run -cidfile /tmp/docker_test.cid ubuntu echo "test"
  30. | This will create a container and print "test" to the console. The cidfile flag makes docker attempt to create a new file and write the container ID to it. If the file exists already, docker will return an error. Docker will close this file when docker run exits.