NAME

       docker-cp - Copy files or folders from a container's PATH to a HOSTDIR or to STDOUT.

SYNOPSIS

       docker cp [--help] CONTAINER:PATH HOSTDIR|-

DESCRIPTION

       Copy  files  or  folders  from  a  CONTAINER:PATH  to  the  HOSTDIR  or  to  STDOUT.   The
       CONTAINER:PATH is relative to the root of the container's filesystem. You  can  copy  from
       either a running or stopped container.

       The  PATH  can be a file or directory. The docker cp command assumes all PATH values start
       at the / (root) directory. This means supplying the initial forward slash is optional; The
       command            sees            compassionate_darwin:/tmp/foo/myfile.txt            and
       compassionate_darwin:tmp/foo/myfile.txt as identical.

       The HOSTDIR refers to a directory on the host. If you do not specify an absolute path  for
       your  HOSTDIR  value, Docker creates the directory relative to where you run the docker cp
       command. For example, suppose you want to copy the /tmp/foo directory from a container  to
       the  /tmp  directory  on your host. If you run docker cp in your   (home) directory on the
       host:

                  $ docker cp compassionate_darwin:tmp/foo /tmp

       Docker creates a /tmp/foo directory on your host. Alternatively, you can omit the  leading
       slash in the command. If you execute this command from your home directory:

                  $ docker cp compassionate_darwin:tmp/foo tmp

       Docker creates a  /tmp/foo subdirectory.

       When  copying  files  to  an  existing  HOSTDIR,  the cp command adds the new files to the
       directory. For example, this command:

                  $ docker cp sharp_ptolemy:/tmp/foo/myfile.txt /tmp

       Creates a /tmp/foo directory on the host containing the myfile.txt file. If you repeat the
       command but change the filename:

                  $ docker cp sharp_ptolemy:/tmp/foo/secondfile.txt /tmp

       Your host's /tmp/foo directory will contain both files:

                  $ ls /tmp/foo
                  myfile.txt secondfile.txt

       Finally, use '-' to write the data as a tar file to STDOUT.

OPTIONS

       --help
         Print usage statement

EXAMPLES

       An  important  shell  script  file,  created  in  a  bash shell, is copied from the exited
       container to the current dir on the host:

              # docker cp c071f3c3ee81:setup.sh .

HISTORY

       April 2014, Originally compiled by William Henry (whenry  at  redhat  dot  com)  based  on
       docker.com  source  material  and  internal  work.   June  2014,  updated by Sven Dowideit
       ⟨SvenDowideit@home.org.au⟩