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-demoEl 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ón | Qué revisar |
|---|---|
| El contenedor aparece activo | Comprueba nombre, imagen, estado y puertos. |
| El contenedor aparece detenido | Revisa logs o decide si debes iniciarlo, reiniciarlo o eliminarlo. |
| El comando falla por permisos | Vuelve 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-demoSin -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-demodocker 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
- Cómo listar contenedores
- Cómo nombrar contenedores
- Cómo iniciar contenedores
- Cómo detener contenedores
- Docker Permission Denied
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.

