Al crear un contenedor, Docker puede asignarle un nombre aleatorio. Con –name puedes elegir uno reconocible y usarlo en órdenes como logs, inspect, stop o exec, en lugar de copiar un ID largo.
El nombre identifica al contenedor dentro del motor Docker y del contexto activo. No cambia la imagen ni el contenido del contenedor, y no es lo mismo que un nombre de servicio de Compose o un alias de red.
👉 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.
Sintaxis para nombrar un contenedor
Puedes asignar el nombre al crear un contenedor con docker run. En este ejemplo, el nombre será web-demo y la imagen que se ejecutará es Nginx:
docker run -d --name web-demo -p 8080:80 nginx:stable-alpineLa opción -d ejecuta el contenedor en segundo plano; -p publica el puerto 80 del contenedor en el puerto 8080 del equipo. El nombre web-demo es una elección del ejemplo: usa uno que describa el propósito real del servicio.
Qué significa el nombre y cómo elegirlo
| Identificador | Qué representa | Ejemplo |
|---|---|---|
| Nombre del contenedor | Alias legible para manejar una instancia concreta en el motor Docker actual. | web-demo |
| ID del contenedor | Identificador generado por Docker para esa instancia. | Se puede consultar con docker ps. |
| Nombre de imagen | Plantilla usada para crear contenedores. Puede incluir repositorio y tag. | nginx:stable-alpine |
| Servicio de Compose | Nombre lógico de un servicio dentro del proyecto Compose. | web |
| Alias de red | Nombre por el que otros contenedores pueden resolver un destino en una red compatible. | web en una red bridge personalizada |
Elige nombres breves y consistentes, por ejemplo app-entorno-función: web-dev, api-test o worker-prod. No incluyas contraseñas, tokens ni datos personales. En equipos con varios Docker contexts, recuerda que el mismo nombre puede existir en motores distintos.
Consultar y usar el nombre del contenedor
Lista contenedores activos y detenidos para confirmar el nombre y el estado. La opción -a incluye también los que ya terminaron:
docker ps -aDespués puedes usar el nombre como argumento de otros comandos. Estas órdenes muestran el contenedor, consultan sus logs y lo detienen de forma ordenada:
docker container inspect web-demo
docker logs --tail 20 web-demo
docker stop web-demoEl filtro name de docker ps puede encontrar coincidencias parciales. Si necesitas confirmar que existe exactamente un contenedor llamado web-demo, usa docker container inspect web-demo o revisa cuidadosamente el resultado de la lista.
Cambiar el nombre de un contenedor existente
Si el contenedor ya existe, puedes cambiar su nombre con docker container rename. El nuevo nombre debe estar libre en el motor Docker activo:
docker container rename web-demo web-lab
docker container inspect web-labRenombrar no crea un contenedor nuevo ni cambia su imagen, ID, puertos o datos. Si el destino ya tiene ese nombre, Docker rechazará el cambio; lista primero los contenedores y decide cuál debe conservar cada nombre.
Nombres de contenedor y Docker Compose
Docker Compose administra servicios y crea nombres de contenedor a partir del proyecto y del servicio. En general, deja que Compose gestione esos nombres: fijar container_name en el archivo Compose puede impedir escalar un servicio a varias instancias porque un nombre fijo no puede repetirse.
En una red bridge definida por el usuario, los contenedores pueden descubrirse por nombre o alias de red. En la bridge predeterminada, la resolución automática por nombre no funciona igual. Por eso, no asumas que un nombre usado localmente por Docker será resoluble desde cualquier red.
Errores comunes al asignar nombres
- El nombre ya está en uso: puede pertenecer a un contenedor detenido. Identifícalo con docker ps -a antes de renombrar o eliminar nada.
- Se confunde el nombre con la imagen: –name identifica el contenedor; nginx:stable-alpine identifica la imagen.
- Se espera que renombrar cambie el servicio: la orden solo cambia el alias local del contenedor, no modifica el proceso ni su configuración de red.
- Se fuerza container_name en Compose: un nombre fijo limita la posibilidad de escalar el servicio.
- Se interpreta el nombre como DNS universal: la resolución depende de la red Docker a la que están conectados los contenedores.
Lecciones relacionadas del curso Docker
- Creando tu primer contenedor en Docker: crea una instancia de prueba antes de renombrarla.
- Cómo listar contenedores Docker: localiza nombres y estados en el motor activo.
- Contenedores en modo interactivo: usa nombres para iniciar una sesión de diagnóstico.
- Índice del curso de Docker: consulta el orden de las lecciones.
Documentación oficial
Consulta la referencia de Docker para docker run, docker container rename y container_name en Compose.

