Tutoriales de VPS
Docker exec format error: AMD64, ARM64, binarios y scripts de entrada
Compara plataformas del daemon, imagen y binario, consulta manifests, reconstruye para el destino y revisa el script antes de recrear el servicio.

El contenedor termina al arrancar con exec /bin/sh: exec format error. Si la imagen viene de un Mac Apple Silicon, equipo ARM u otro servidor, compara primero VPS, plataforma de imagen y ejecutable interno. Reinstalar Docker no hace compatible un binario.
exec format error también puede deberse al formato del script de entrada. Sigue archivo que falla → destino de ejecución → contenido de imagen. Cambia repositorio yourname/myapp, etiquetas y servicio app por los reales.
| Síntoma | Primera comprobación | Evita una solución ajena |
|---|---|---|
| no matching manifest al descargar | Plataforma disponible en la etiqueta | Reiniciar Docker repetidamente |
Falla /bin/sh | Plataforma y emulación disponible | chmod 777 al script |
No ejecuta /app/server | Sistema y arquitectura del binario | Cambiar solo etiqueta o platform |
Falla entrypoint.sh | Intérprete, saltos de línea y cabecera | Atribuir todo a ARM |
| permission denied | Permisos, montajes y seguridad | Confundirlo con error de formato |
Conserva error y ruta originales:
docker compose ps -a
docker compose logs --tail=80 app
Antes de iniciar el proceso, el log de aplicación puede estar vacío; registra también el error de arranque. Para reinicios sin causa identificada, consulta Restarting.
Ejecuta en el VPS de destino, no en el Mac:
uname -m
docker context show
docker info --format '{{.OSType}}/{{.Architecture}}'
docker image inspect yourname/myapp:2026-10-23 --format '{{.Os}}/{{.Architecture}}'
image inspect consulta una imagen local y falla si no existe. No lista todas las plataformas del registro remoto; consulta Docker inspect.
| Sistema | Plataforma habitual | Significado |
|---|---|---|
| x86_64 | linux/amd64 | x86 de 64 bits, Intel o AMD |
| aarch64 | linux/arm64 | ARM de 64 bits |
| armv7l | linux/arm/v7 | ARM de 32 bits, distinto de arm64 |
Revisa Docker context: el cliente puede usar un daemon remoto y uname -m describir otra máquina. Confirma qué servidor Docker estás administrando.
Un build local normal de Apple Silicon suele producir ARM64 y muchos VPS x86 necesitan AMD64. Un constructor remoto o plataforma explícita puede cambiarlo; utiliza metadatos, no el nombre del ordenador.
Consulta el manifest con Buildx:
docker buildx imagetools inspect yourname/myapp:2026-10-23
Busca linux/amd64 o linux/arm64, según el destino. A diferencia de docker image inspect local, consulta el registro. Autentica el registro privado con tus permisos y revisa Buildx si falta. Consulta imagetools inspect.
no matching manifest significa que falta la plataforma, no timeout de red. Usa una imagen oficial compatible o reconstruye tu aplicación. Un manifest de plataforma única puede tener otra presentación; una salida corta no demuestra corrupción.
Para un VPS AMD64, selecciona esa plataforma al construir:
docker buildx build \
--platform linux/amd64 \
-t yourname/myapp:2026-10-23-amd64 \
--push .
El comando publica en un registro donde necesitas escritura. Sustituye repositorio, autentica y usa ARM64 para un VPS ARM64. Guarda la etiqueta anterior y prueba la nueva en una instancia de prueba antes de perder la reversión. Consulta buildx build.
Para cargar un resultado de una plataforma en el almacén local, sustituye --push por --load. La carga multiplataforma depende del driver y almacén; el ejemplo no la garantiza.
Para AMD64 y ARM64 juntos:
docker buildx build \
--platform linux/amd64,linux/arm64 \
-t yourname/myapp:2026-10-23 \
--push .
Comprueba el constructor con docker buildx ls. Pueden necesitarse nodos nativos, compilación cruzada o QEMU. Instalar Buildx no habilita cualquier ejecutable y compilar/comprimir bajo emulación puede ser mucho más lento; consulta builds multiplataforma.
Revisa Dockerfile. Si COPY solo copia un ejecutable compilado en macOS, --platform linux/amd64 no lo convierte en Linux AMD64. Go, Rust y dependencias nativas de Python/Node necesitan su herramienta de compilación para el destino. Metadatos correctos no garantizan binarios correctos.
Una vez confirmada la variante de imagen, puedes fijarla:
services:
app:
image: yourname/myapp:2026-10-23-amd64
platform: linux/amd64
restart: unless-stopped
Compose platform selecciona plataforma y variante. No transforma binarios ARM ni instala emulación. Forzar AMD64 en ARM puede requerir emulador; prefiere nativo para producción cuando sea posible.
Comprueba proyecto original, entorno, montajes y respaldo antes del mantenimiento:
docker compose config --quiet
docker compose pull app
docker compose up -d --no-deps app
docker compose ps app
Se supone directorio real y dependencias operativas. Conserva -f, --env-file y nombre del proyecto. restart no aplica la imagen nueva; consulta cambios Compose no aplicados. Confirma datos montados y respaldados antes de recrear; no hace falta borrar volúmenes.
Comprueba el archivo fuente:
file entrypoint.sh
head -n 1 entrypoint.sh
od -An -tx1 -N32 entrypoint.sh
Un script ejecutado directamente requiere una primera línea como #!/bin/sh y ese intérprete debe existir. Cambiar Bash por sh en la cabecera no adapta su sintaxis. Consulta execve de Linux.
Revisa BOM UTF-8, CRLF de Windows y bit de ejecución. CRLF puede añadir un retorno al nombre del intérprete y causar un error distinto del de arquitectura. permission denied requiere revisar permisos aparte. Respalda, guarda con LF sin BOM y valida con el intérprete correcto. No reemplaces saltos de línea masivamente en binarios.
Si termina enseguida, docker exec normalmente no puede entrar. Revisa fuentes; para extraer archivos de imagen utiliza un contenedor temporal específico y docker cp. Evita parches manuales en contenedores de producción imposibles de reproducir desde el código.
Confirma arquitectura del daemon, plataforma de etiqueta y ejecutable interno. Prueba una petición real y revisa errores de formato. Comprueba montajes y datos; guarda etiqueta y configuración anteriores para revertir.
Son comandos de diagnóstico, no pruebas de despliegue sobre las dos arquitecturas. Identifica archivo, compara plataforma y revisa script y compilación. Añadir platform no completa por sí solo la reparación.