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⟩

Docker Community                               Docker User Manuals                                     DOCKER(1)