NAME

       docker-container-attach - Attach local standard input, output, and error streams to a running container

SYNOPSIS

       docker container attach [OPTIONS] CONTAINER

DESCRIPTION

       The  docker  attach command allows you to attach to a running container using the container's ID or name,
       either to view its ongoing output or to control it interactively.  You can attach to the  same  contained
       process  multiple  times  simultaneously,  screen  sharing  style,  or  quickly view the progress of your
       detached process.

       To stop a container, use CTRL-c. This key sequence sends SIGKILL to the container. You  can  detach  from
       the  container  (and  leave it running) using a configurable key sequence. The default sequence is CTRL-p
       CTRL-q. You configure the key sequence using the  --detach-keys  option  or  a  configuration  file.  See
       config-json(5) for documentation on using a configuration file.

       It  is  forbidden  to  redirect  the  standard input of a docker attach command while attaching to a TTY-
       enabled container (i.e., launched with -i and -t).

EXAMPLES

Attaching to a container

       In this example the top command is run inside a container from an ubuntu image, in  detached  mode,  then
       attaches to it, and then terminates the container with CTRL-c:

       $ docker run -d --name topdemo ubuntu:20.04 /usr/bin/top -b
       $ docker attach topdemo
       top - 00:07:01 up  4:54,  0 users,  load average: 0.83, 0.91, 0.82
       Tasks:   1 total,   1 running,   0 sleeping,   0 stopped,   0 zombie
       %Cpu(s):  2.3 us,  1.6 sy,  0.0 ni, 95.9 id,  0.0 wa,  0.1 hi,  0.1 si,  0.0 st
       MiB Mem :  15846.2 total,   5729.2 free,   2592.5 used,   7524.4 buff/cache
       MiB Swap:  16384.0 total,  16384.0 free,      0.0 used.  12097.3 avail Mem

           PID USER      PR  NI    VIRT    RES    SHR S  %CPU  %MEM     TIME+ COMMAND
             1 root      20   0    5976   3256   2828 R   0.0   0.0   0:00.04 top
       ^C

Override the detach sequence

       Use  the  --detach-keys  option  to  override  the Docker key sequence for detach.  This is useful if the
       Docker default sequence conflicts with key sequence you use for other applications. There are two ways to
       define  your own detach key sequence, as a per-container override or as a configuration property on  your
       entire configuration.

       To override the sequence for an individual container, use the  --detach-keys=key  flag  with  the  docker
       attach  command. The format of the key is either a letter [a-Z], or the ctrl-value, where value is one of
       the following:

              • a-z (a single lowercase alpha character )

              • @ (at sign)

              • [ (left bracket)

              • *\\* (two backward slashes)

              • _ (underscore)

              • ^ (caret)

       These a, ctrl-a, X, or *ctrl-\* values are all examples of valid key sequences. To configure a  different
       configuration default key sequence for all containers, see docker(1).

OPTIONS

       --detach-keys=""      Override the key sequence for detaching a container

       -h, --help[=false]      help for attach

       --no-stdin[=false]      Do not attach STDIN

       --sig-proxy[=true]      Proxy all received signals to the process

SEE ALSO

       docker-container(1)