Attaching to running containers in Docker - Commands & Configuration

Introduction

Sometimes you need to see what is happening inside a running container or interact with its main process. Attaching to a running container lets you connect your terminal directly to it, so you can watch output or send input.

When you want to see live logs or output from a container's main process in real time.

When you need to interact with a container's running application, like a shell or a command line tool.

When debugging a container to understand what it is doing or why it might be stuck.

When you want to manually control a container process without restarting it.

When you want to confirm that a container is running as expected by observing its output.

Commands

List all running containers so you can find the container ID or name to attach to.

Terminal

docker ps

Expected Output

CONTAINER ID   IMAGE          COMMAND                  CREATED         STATUS         PORTS                    NAMES

b7f3a1c2d4e5   nginx:1.23.3   "/docker-entrypoint.…"   2 minutes ago   Up 2 minutes   0.0.0.0:8080->80/tcp     my-nginx

Attach your terminal to the running container named 'my-nginx' to see its output and interact with it if possible.

Terminal

docker attach my-nginx

Expected Output

172.17.0.1 - - [27/Apr/2024:12:00:00 +0000] "GET / HTTP/1.1" 200 612 "-" "curl/7.68.0"

Stops the container process. To detach without stopping, use the detach sequence Ctrl + P then Ctrl + Q.

Terminal

Ctrl + C

Expected Output

No output (command runs silently)

Open a new interactive shell session inside the running container without attaching to the main process.

Terminal

docker exec -it my-nginx /bin/bash

Expected Output

root@b7f3a1c2d4e5:/#

→

-i - Keep STDIN open even if not attached

→

-t - Allocate a pseudo-TTY for interactive shell

Key Concept

If you remember nothing else from this pattern, remember: attaching connects your terminal to the container's main process to see or interact with it live.

Common Mistakes

Using Ctrl + C to detach from the container

Ctrl + C stops the container process, which shuts down the container instead of detaching.

Use the detach key sequence Ctrl + P then Ctrl + Q to safely detach without stopping the container.

Trying to attach to a container that is not running

You cannot attach to a container that is stopped or paused; the command will fail.

Check the container status with 'docker ps' and ensure it is running before attaching.

Expecting to get a shell when attaching to containers that do not run a shell

Attach connects to the main process, which might not be a shell, so you cannot interact like a terminal.

Use 'docker exec -it <container> /bin/bash' to open a shell inside the container if available.

Summary

Use 'docker ps' to find the running container you want to attach to.

Run 'docker attach <container-name>' to connect your terminal to the container's main process.

Detach safely using Ctrl + P then Ctrl + Q to avoid stopping the container.

Use 'docker exec -it <container-name> /bin/bash' to open a new shell session inside the container.