When you run containers in Docker, sometimes you need to interact directly with the container’s process (attach) and sometimes you want to disconnect without stopping it (detach).
Understanding how to attach and detach properly is crucial for debugging, running interactive applications, and managing long-running processes.
1️⃣ What Does “Attach” Mean in Docker?
Attaching means connecting your terminal’s standard input/output (stdin/stdout/stderr) to the container’s main process.
For example:
docker run -it ubuntu bash
Here, your terminal is directly attached to the bash process inside the container.
2️⃣ Detaching from a Running Container
If you’re inside a container and want to leave it running in the background:
- Use the detach key sequence:
Ctrl + P, then Ctrl + Q
This:
- Detaches your terminal from the container.
- Leaves the container running in the background.
✅ Example:
docker run -it ubuntu
# Press Ctrl+P, Ctrl+Q → Container keeps running
3️⃣ Attaching Back to a Container
If you want to reattach later:
docker attach <container_id_or_name>
This reconnects you to the main process (usually PID 1).
⚠️ Note: If the process doesn’t produce output or accept input, it may look “frozen.”
4️⃣ Using docker exec Instead of attach
Sometimes you don’t want to attach to the container’s main process but instead run a new interactive shell inside the container.
docker exec -it <container_id_or_name> bash
or, if bash isn’t available:
docker exec -it <container_id_or_name> sh
This is safer than docker attach because:
- It doesn’t interfere with the container’s main process.
- Multiple exec sessions can run simultaneously.
5️⃣ Running Containers in Detached Mode
You can start containers detached from the beginning:
docker run -dit ubuntu bash
-d→ run in detached mode-i→ keep STDIN open-t→ allocate a pseudo-TTY
Later, you can use docker attach or docker exec to interact.
📌 Summary
- Detach from running container:
Ctrl+P, Ctrl+Q - Attach again:
docker attach <container> - Run new shell instead of attaching:
docker exec -it <container> bash - Start detached:
docker run -dit <image> <command>
👉 Use docker exec when you want a safe, interactive session. Use docker attach when you want to reconnect to the container’s main process.