docker exec -it abre una shell interactiva dentro de un contenedor que ya está en marcha: -i mantiene la entrada abierta y -t asigna una terminal. En producción, entra con sh si no sabes qué hay, fija usuario con -u y directorio con --workdir, y no cambies nada que no sobreviva a recrear el contenedor.
docker exec -it: sintaxis mínima y qué hace cada flag
La forma básica es docker exec [opciones] CONTENEDOR COMANDO, y el comando se ejecuta en el contenedor que ya corre, sin crear uno nuevo. Primero localiza el nombre exacto y después entra:
docker ps
docker exec -it api sh
# Con Docker Compose, por nombre de servicio
docker compose exec api sh-i conecta tu entrada estándar al proceso y -t le da una pseudo-terminal; sin -t no verás prompt ni podrás editar la línea. docker compose exec asigna terminal por defecto y se desactiva con -T, útil en scripts. Si el contenedor está reiniciándose en bucle, exec fallará: en ese caso mira antes docker logs --tail 100 api.
sh frente a bash en docker exec: cómo saber qué shell trae la imagen
Muchas imágenes mínimas, como las basadas en Alpine, traen sh pero no bash, y las imágenes distroless no traen ninguna shell. Si pides bash y no existe, Docker devuelve un error de ejecutable no encontrado en $PATH. Compruébalo sin adivinar:
docker exec api sh -c 'command -v bash || echo sin-bash'
# Si hay bash, úsalo; si no, quédate en sh
docker exec -it api bash
docker exec -it api shEntrar con sh es la apuesta segura: funciona casi siempre y no necesitas autocompletado avanzado para leer logs o revisar configuración. No instales bash con el gestor de paquetes dentro del contenedor para estar más cómodo: esa instalación desaparece en el siguiente despliegue. Si la imagen no tiene shell, docker cp sigue funcionando para sacar archivos y revisarlos fuera.
Usuario en docker exec: -u, root y archivos con dueño equivocado
docker exec usa por defecto el mismo usuario que el proceso principal del contenedor, es decir, el USER de la imagen o el --user con el que se creó. Comprueba quién eres antes de tocar nada:
docker inspect --format '{{.Config.User}}' api
docker exec api id
# Root solo para lo imprescindible
docker exec -it -u 0 api sh
# Mismo UID:GID que la aplicación
docker exec -it -u 1000:1000 api shSi docker inspect devuelve una cadena vacía, el contenedor corre como root. El riesgo real de -u 0 no es solo la seguridad: un archivo creado como root dentro de un volumen compartido puede impedir que la aplicación, que corre con otro UID, lo escriba después. Regla práctica: lee como el usuario de la aplicación y usa root para una acción concreta, saliendo justo después.
--workdir en docker exec: abrir la shell en el directorio que importa
-w o --workdir fija el directorio de trabajo del comando; sin él, docker exec arranca en el WORKDIR de la imagen. Combinado con -u evita el clásico cd equivocado:
docker exec -it -w /var/log/nginx web sh
# Comando suelto, sin shell interactiva
docker exec -w /app api ls -la
# Usuario y directorio a la vez
docker exec -it -u www-data -w /var/www/html web shPara consultas de una sola línea no necesitas -it: un docker exec sin terminal devuelve la salida y termina, y es más fácil de repetir y de copiar en un informe de incidencia.
Cambios en un contenedor con docker exec que no sobreviven al recreate
Todo lo que escribes fuera de un volumen va a la capa escribible del contenedor, y docker compose up -d --force-recreate o cualquier despliegue nuevo la descarta. Un docker restart la conserva, lo que da una falsa sensación de que el arreglo es permanente. Antes de salir, revisa qué has tocado:
# A = añadido, C = cambiado, D = borrado
docker diff api
# Rutas que sí persisten (volúmenes y bind mounts)
docker inspect --format '{{range .Mounts}}{{.Destination}} {{end}}' api
# Saca una copia antes de investigar
docker cp api:/app/config/settings.yml ./settings.yml- No instales paquetes para depurar; desaparecen y además cambian la imagen que crees estar ejecutando.
- No edites configuración dentro del contenedor; corrígela en la imagen, en el compose o en el volumen.
- No cambies permisos con chmod o chown fuera de un volumen; el siguiente recreate los devuelve a su estado.
- No mates el PID 1; si muere el proceso principal, se detiene el contenedor entero.
docker exec -it desde el móvil frente al escritorio: qué cambia
Entrar en un contenedor desde el teléfono exige dos cosas que el escritorio da por hechas: teclas como Ctrl y Tab, y una sesión que no se caiga al moverte. Así se compara:
| Necesidad durante docker exec | Escritorio | Móvil con termi1 |
|---|---|---|
| Ctrl+C, Ctrl+D, Tab y flechas | Teclado físico | Teclado propio con Esc, Ctrl, Tab y flechas |
| Cambio de red | Con SSH se pierde la shell abierta | Mosh mantiene la sesión al pasar de wifi a datos |
| Tareas largas en el host | tmux a mano | tmux: lo que queda corriendo sigue ahí al volver |
| Bajar un archivo copiado con docker cp | scp o sftp desde otra ventana | SFTP integrado sin salir de la sesión |
| Escribir el comando | A mano o desde el historial | La IA lo escribe en el prompt sin pulsar Intro |
En una conexión etiquetada como producción, el Production Guard de termi1, terminal SSH para móvil impide que nada reciba Intro automáticamente y retiene lo que borra, detiene o cambia algo antes de llegar al prompt, así que un docker exec con -u 0 nunca se lanza solo. La IA no abre la sesión ni recibe claves, y la clave privada SSH no sale del teléfono. Puedes instalarla desde la app de termi1 en App Store; otras guías de servidores están en el blog técnico de termi1.
Preguntas frecuentes
¿Por qué docker exec -it no encuentra bash en el contenedor?
docker exec -it no encuentra bash porque muchas imágenes mínimas, como las basadas en Alpine, solo incluyen sh, y las distroless no incluyen ninguna shell. Usa docker exec -it contenedor sh, y si no hay shell, extrae archivos con docker cp para revisarlos desde el host.
¿Cómo entro como root en un contenedor con docker exec?
Para entrar como root con docker exec se usa -u 0, por ejemplo docker exec -it -u 0 api sh. Úsalo solo para una acción concreta: los archivos que crees como root en un volumen pueden quedar inaccesibles para la aplicación, que suele correr con otro UID.
¿Se pierden los cambios hechos con docker exec al reiniciar el contenedor?
Los cambios hechos con docker exec fuera de un volumen sobreviven a docker restart, pero se pierden al recrear el contenedor con docker compose up -d --force-recreate o con un despliegue nuevo. docker diff muestra qué archivos has añadido, cambiado o borrado en la capa escribible.
¿Qué diferencia hay entre docker exec y docker attach?
docker exec arranca un proceso nuevo dentro del contenedor, mientras que docker attach se conecta a la entrada y salida del proceso principal. Con attach, un Ctrl+C puede llegar al proceso principal y detener el contenedor; para inspeccionar producción, docker exec es la opción prudente.