Docker: Cómo detener todos los contenedores

Cuando estás dando tus primeros pasos en el mundo del desarrollo con Docker, es común que termines con múltiples contenedores corriendo simultáneamente. Algunos están en pruebas, otros en producción local, y otros simplemente quedaron olvidados tras un docker run. En algún punto, vas a necesitar limpiar tu entorno y detener todos esos contenedores. Y es aquí donde muchos se preguntan: ¿Cómo detengo todos los contenedores de Docker de una sola vez?

La buena noticia es que Docker ofrece comandos directos y eficientes para realizar esta tarea sin complicaciones. No necesitas un script complejo ni una herramienta adicional: solo necesitas conocer bien las instrucciones adecuadas, y eso es precisamente lo que te vamos a explicar en este artículo.

Detener todos los contenedores en ejecución: el comando clave

La forma más directa y recomendada para detener todos los contenedores que se están ejecutando actualmente es esta:

docker stop $(docker ps -q)

Vamos a desglosar lo que sucede aquí:

• docker ps -q lista todos los IDs de los contenedores que están activos (la opción -q significa quiet, por lo que solo devuelve los IDs).
• docker stop recibe como argumento una lista de IDs, y los detiene uno por uno.

Este comando es seguro y efectivo. Si no hay contenedores activos, no hará nada ni generará errores. En entornos de desarrollo, puede ahorrarte varios minutos de comandos repetitivos.

¿Y si también quiero eliminar los contenedores?

A menudo, detener no es suficiente. Muchos desarrolladores quieren limpiar su entorno por completo, incluyendo la eliminación de contenedores detenidos. En ese caso, el siguiente paso es usar:

docker rm $(docker ps -a -q)

Este comando elimina todos los contenedores, estén o no en ejecución (porque docker ps -a lista todos). Pero atención: no podrás eliminar un contenedor que esté corriendo. Por eso es importante detenerlos primero con docker stop.

Para hacer ambas cosas en una sola línea, puedes encadenar comandos:

docker stop $(docker ps -q) && docker rm $(docker ps -a -q)

Este combo es muy utilizado en entornos de staging y testing, donde los contenedores son efímeros.

¿Por qué detener contenedores de Docker?

Detener contenedores tiene implicaciones tanto en rendimiento como en seguridad. Cada contenedor activo consume recursos: CPU, memoria, espacio en disco (si genera logs o caché). Además, los puertos que exponen podrían estar interfiriendo con otros servicios locales.

Según un estudio publicado por Datadog en 2023, más del 70% de los desarrolladores que usan Docker de forma habitual tienen al menos tres contenedores corriendo simultáneamente en su máquina local, incluso cuando no los están utilizando. Esto genera cuellos de botella que afectan tanto el rendimiento del sistema como la estabilidad de los entornos de prueba.

¿Qué pasa con los contenedores en producción?

En entornos de producción, detener todos los contenedores no suele ser una buena práctica, a menos que formes parte de una estrategia de reinicio controlado (como parte de una pipeline de CI/CD o una actualización mayor). En esos casos, se suelen usar herramientas como Docker Compose o Kubernetes para manejar los servicios de manera más robusta.

Si estás usando docker-compose, puedes detener todos los servicios definidos en tu archivo docker-compose.yml con:

docker-compose down

Este comando detiene y elimina todos los contenedores, redes y volúmenes definidos por el archivo. Ideal para cerrar un proyecto completo de forma ordenada.

Automatiza: crea tu propio alias

Si te encuentras deteniendo contenedores frecuentemente, puedes agregar un alias en tu archivo ~/.bashrc o ~/.zshrc:

alias docker-stop-all="docker stop \$(docker ps -q)"

Después de recargar la terminal, bastará con ejecutar docker-stop-all para detener todo de un solo golpe.

Buenas prácticas: cuándo detener y cuándo eliminar

Como agencia de desarrollo de software, recomendamos seguir estos lineamientos:

• En desarrollo: detén los contenedores cuando termines tu jornada, especialmente si trabajas con servicios que consumen muchos recursos como bases de datos, servidores de archivos o proxies.
• En testing: elimina los contenedores cuando ya no los necesites. Así mantienes tu entorno limpio y evitas conflictos de red o puertos.
• En producción: utiliza herramientas de orquestación y evita hacer limpieza manual salvo que estés haciendo mantenimiento planificado.

Conclusión: control total sobre tu entorno Docker

Saber cómo detener todos los contenedores de Docker no solo es una habilidad útil, sino esencial para cualquier desarrollador que quiera mantener su entorno bajo control. Este pequeño comando puede marcar una gran diferencia en la estabilidad, rendimiento y organización de tu entorno local.

En Rootstack, ayudamos a equipos de desarrollo a implementar entornos Docker optimizados, automatizados y preparados para escalar. Si estás empezando con Docker o quieres llevar tu arquitectura a un siguiente nivel, nuestro equipo puede ayudarte con configuraciones personalizadas, automatización con Docker Compose, integración con CI/CD y despliegue en la nube.

Te recomendamos en video