Cómo eliminar contenedores

como-eliminar-contenedores-docker
como-eliminar-contenedores-docker

En esta lección aprenderás cómo eliminar contenedores dentro de Docker con comandos seguros y un flujo práctico. La idea es que puedas administrar contenedores básicos sin memorizar IDs largos ni ejecutar acciones destructivas por costumbre.

El comando normal elimina un contenedor detenido. No elimina la imagen que lo creó ni, por defecto, los volúmenes nombrados; los datos guardados solo en la capa escribible del contenedor sí desaparecen con él.

👉 Y recuerda, si quieres aprender más de Linux, visita el curso de Linux gratis.

🐳 Si quieres aprender más de Docker, visita el curso de Docker gratis.

Qué elimina docker rm y qué conserva

docker rm elimina el objeto contenedor: su configuración y la capa escribible. No elimina la imagen de origen ni los volúmenes nombrados. Si el contenedor está activo, detenlo antes para permitir el cierre ordenado o usa -f solo cuando aceptes una interrupción inmediata.

  • Consulta docker ps -a y confirma el nombre en la columna NAMES y el estado en STATUS.
  • Comprueba si los datos que necesitas siguen únicamente en la capa escribible: al quitar el contenedor, esa capa desaparece.
  • Revisa los montajes con docker inspect antes de decidir si también necesitas eliminar algún volumen.
  • Evita -v salvo que hayas comprobado que no necesitas los volúmenes anónimos asociados.

Si aún no tienes un contenedor de prueba, repasa la configuración inicial recomendada de Docker y cómo crear tu primer contenedor.

Elimina contenedores sin borrar de más

Para quitar un contenedor detenido, ejecuta docker rm seguido de su nombre o ID. En este ejemplo se usa web-demo; sustituye ese nombre por el que hayas comprobado en tu equipo.

Si el contenedor sigue en ejecución, docker rm devuelve un error. Detenerlo primero es el flujo habitual: docker stop solicita un apagado ordenado y docker rm lo elimina después de que se haya detenido.

docker stop web-demo
docker rm web-demo

El primer comando espera a que Docker detenga web-demo; el segundo elimina el contenedor detenido. Si necesitas conservar datos de la aplicación, comprueba antes que estén en un volumen o bind mount y no solo en la capa escribible.

Eliminar un contenedor en ejecución con -f

La opción -f fuerza la eliminación de un contenedor activo y envía SIGKILL a su proceso principal. No permite un cierre gradual; úsala solo si aceptas interrumpir el servicio y ya verificaste que el contenedor correcto puede desaparecer.

docker rm -f web-demo
SituaciónQué revisar
El contenedor aparece activoComprueba nombre, imagen, estado y puertos.
El contenedor aparece detenidoRevisa logs o decide si debes iniciarlo, reiniciarlo o eliminarlo.
El comando falla por permisosVuelve a la lección Docker Permission Denied antes de seguir.

Qué cambia al añadir -v

La opción -v también elimina los volúmenes anónimos asociados al contenedor. Antes de ejecutarla, revisa sus montajes con docker inspect: los volúmenes nombrados se conservan, pero los anónimos pueden contener datos que no se pueden recuperar.

docker rm -v web-demo

Sin -v, Docker conserva los volúmenes aunque elimines el contenedor. Con -v, borra los anónimos asociados; no borra los nombrados. La opción no elimina imágenes ni sustituye una copia de seguridad.

Checklist práctico para eliminar contenedores

Repasa estas comprobaciones antes de ejecutar el comando que corresponda:

  • Comprueba identidad y estado antes de ejecutar cualquier eliminación.
  • Prefiere detener y eliminar; reserva -f para cuando aceptes enviar SIGKILL al proceso principal.
  • Revisa los montajes antes de añadir -v; los volúmenes anónimos asociados se eliminan, los nombrados se conservan.
docker ps -a --filter "name=web-demo"
docker stop web-demo
docker rm web-demo

docker rm no elimina imágenes Docker ni volúmenes nombrados automáticamente. Elimina el contenedor; si usas -v, revisa si hay volúmenes anónimos que puedan contener datos que todavía necesitas.

Errores comunes

  • Usar -f sin revisar qué proceso estás matando.
  • Confundir contenedores con imágenes o volúmenes.
  • Usar prune en servidores compartidos sin inventario.

Advertencia: este tema puede interrumpir servicios o eliminar contenedores. Antes de actuar, confirma nombre, estado y si hay datos que debas conservar.

Lecciones relacionadas del curso

Documentación oficial y recursos

Para confirmar que ya no existe, vuelve a listar los contenedores con el filtro name=web-demo. Si no aparece ninguna fila, Docker ya no encuentra un contenedor con ese nombre; la imagen de origen sigue disponible. Eliminar el contenedor por sí solo no libera espacio ocupado por imágenes o volúmenes.

Comentarios

No hay comentarios aún. ¿Por qué no comienzas el debate?

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *