Docker commands Guide – docker attach with examples

Here’s a complete tutorial on docker attach, including how it works, its use cases, and a comprehensive list of examples.

What is docker attach?

docker attach connects your terminal to a running Docker container’s standard input (stdin), output (stdout), and error (stderr) streams. This means you can interact directly with the container’s process as if it were running in your local terminal.

Key Features of docker attach:

• Real-time access to logs and console output.
• Allows interaction with processes that require input (e.g., shell, interactive services).
• No new process is started in the container (unlike docker exec).

Basic Syntax

docker attach [OPTIONS] CONTAINER
Code language: CSS (css)

Options:

• --detach-keys: Override the default key sequence to detach (default: Ctrl-p + Ctrl-q).
• --no-stdin: Do not attach stdin (useful for viewing logs without interaction).

How docker attach Differs from Other Commands

• docker exec → Starts a new process inside the container.
• docker logs -f → Displays log output but does not allow interactive input.
• docker attach → Connects to the main process of a running container with interactive input and output.

Examples of docker attach

1. Attaching to a Running Container

docker run -it --name my_container ubuntu

This starts an Ubuntu container with an interactive shell. If you detach using Ctrl-p + Ctrl-q, you can reattach:

docker attach my_container

You’ll be back in the container’s shell.

2. Viewing Logs in Real-Time (Without Interacting)

docker attach --no-stdin my_container

This will display the container’s logs without accepting input. Useful for monitoring output.

3. Detaching Gracefully (--detach-keys)

By default, you detach from the container using Ctrl-p + Ctrl-q. You can specify a custom key combination:

docker attach --detach-keys="ctrl-c" my_container
Code language: JavaScript (javascript)

To detach, press Ctrl-c.

4. Attaching to Multiple Containers (One at a Time)

If you have multiple containers running, you can attach to them one by one:

docker ps

Sample output:

CONTAINER ID   IMAGE      COMMAND   CREATED        STATUS       NAMES
d1a6743c1234   ubuntu     bash      2 minutes ago Up 2 minutes my_container
b2b5729c5678   nginx      nginx     5 minutes ago Up 5 minutes nginx_container

Attach to each one:

docker attach my_container
docker attach nginx_container

5. Handling Stopped Containers

docker attach only works with running containers. If you try to attach to a stopped container, you’ll get an error:

docker attach stopped_container

Error:

Error: No such container: stopped_container
Code language: JavaScript (javascript)

You must start the container first:

docker start stopped_container
docker attach stopped_container

6. Using Detached Mode with docker run and Reattaching Later

Start a container in detached mode:

docker run -dit --name my_detached_container ubuntu

Reattach at any time:

docker attach my_detached_container

7. Attaching to a Container Running a Web Server

If you have a container running an NGINX web server:

docker run -d --name my_nginx -p 8080:80 nginx
Code language: CSS (css)

You can attach to monitor its logs:

docker attach my_nginx

8. Troubleshooting with docker attach

If a container fails, you can attach to it to see the real-time output of the process and debug the problem.

For example, with a Node.js container:

docker run -d --name node_app my_node_image
docker attach node_app

9. Detach Without Stopping the Container

While attached to the container:

1. Press Ctrl-p + Ctrl-q (default) to detach without stopping it.
2. Check the container is still running: docker ps

Best Practices for Using docker attach

• Avoid using docker attach with containers running critical processes that may get interrupted if you accidentally close the terminal.
• Use --no-stdin when you just want to view logs and don’t need to interact with the process.
• For debugging, combine docker attach with docker logs for maximum insight.

List of All docker attach Commands

Common Errors and Solutions

1. “Cannot attach to stopped container”
   → Start the container with docker start.
2. Session Freezes / No Response
   → Ensure the container process is running. Press Ctrl-p + Ctrl-q to detach safely.
3. Accidentally Interrupting Critical Processes
   → Use docker logs to monitor logs without risking interruption.

Rajesh Kumar

I’m Rajesh Kumar, a DevOps, SRE, DevSecOps, Cloud, and Platform Engineering expert passionate about sharing practical knowledge, real-world experiences, and industry best practices. I have worked at Cotocus and regularly write about technology, travel, investing, health, product reviews, and digital marketing through my various platforms.

I publish technical articles at DevOps School, travel stories at Holiday Landmark, stock market insights at Stocks Mantra, health and fitness guidance at My Medic Plus, product reviews at TrueReviewNow, and SEO and digital marketing strategies at Wizbrand.