Tutoriais de VPS
Docker exec format error: AMD64, ARM64, binários e scripts de entrada
Compare plataformas do daemon, imagem e binário, consulte manifests, reconstrua para o destino e confira o script antes de recriar o serviço.

O contêiner encerra ao iniciar com exec /bin/sh: exec format error. Se a imagem veio de um Mac Apple Silicon, computador ARM ou outro servidor, compare primeiro VPS, plataforma da imagem e executável interno. Reinstalar Docker não torna um binário compatível.
exec format error também pode resultar do formato do script de entrada. Siga arquivo com erro → destino de execução → conteúdo da imagem. Troque repositório yourname/myapp, tags e serviço app pelos seus valores.
| Sintoma | O que conferir | Evite uma correção sem relação |
|---|---|---|
| no matching manifest no pull | Plataforma disponível na tag | Reiniciar Docker repetidamente |
/bin/sh falha | Plataforma e emulação disponível | chmod 777 no script |
/app/server não executa | Sistema e arquitetura do binário | Alterar só tag ou platform |
entrypoint.sh falha | Interpretador, quebras de linha e cabeçalho | Atribuir tudo a ARM |
| permission denied | Permissões, montagens e segurança | Confundir com erro de formato |
Preserve erro e caminho originais:
docker compose ps -a
docker compose logs --tail=80 app
Antes de o processo iniciar, o log da aplicação pode estar vazio; guarde também o erro de inicialização. Para reinícios sem causa identificada, veja Restarting.
Execute no VPS de destino, não no 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 imagem local e falha se ela não existe. Não lista plataformas do registro remoto; veja Docker inspect.
| Sistema | Plataforma comum | Significado |
|---|---|---|
| x86_64 | linux/amd64 | x86 de 64 bits, Intel ou AMD |
| aarch64 | linux/arm64 | ARM de 64 bits |
| armv7l | linux/arm/v7 | ARM de 32 bits, diferente de arm64 |
Confira Docker context: o cliente pode usar um daemon remoto e uname -m descrever outra máquina. Confirme qual servidor Docker você administra.
Um build local comum no Apple Silicon geralmente gera ARM64, enquanto muitos VPS x86 precisam de AMD64. Builder remoto ou plataforma explícita podem mudar isso; use metadados, não o nome do computador.
Consulte o manifest com Buildx:
docker buildx imagetools inspect yourname/myapp:2026-10-23
Procure linux/amd64 ou linux/arm64, conforme o destino. Diferente de docker image inspect local, consulta o registro. Autentique registros privados com suas permissões e confira Buildx se faltar. Veja imagetools inspect.
no matching manifest significa plataforma ausente, não timeout. Use imagem oficial compatível ou reconstrua sua aplicação. Um manifest de plataforma única pode ter apresentação diferente; saída curta não comprova corrupção.
Para um VPS AMD64, selecione essa plataforma no build:
docker buildx build \
--platform linux/amd64 \
-t yourname/myapp:2026-10-23-amd64 \
--push .
O comando publica em um registro no qual você precisa de escrita. Substitua repositório, autentique e use ARM64 no VPS ARM64. Guarde a tag anterior e valide a nova em instância de teste antes de perder a reversão. Veja buildx build.
Para carregar resultado de uma plataforma na biblioteca local, troque --push por --load. Carregamento multiplataforma depende do driver e do armazenamento; o exemplo não o garante.
Para AMD64 e ARM64 juntos:
docker buildx build \
--platform linux/amd64,linux/arm64 \
-t yourname/myapp:2026-10-23 \
--push .
Confira o builder com docker buildx ls. Podem ser necessários nós nativos, compilação cruzada ou QEMU. Instalar Buildx não habilita todo executável e compilar/comprimir em emulação pode ser muito mais lento; consulte builds multiplataforma.
Confira Dockerfile. Se COPY só copia um executável compilado no macOS, --platform linux/amd64 não o converte para Linux AMD64. Go, Rust e dependências nativas de Python/Node precisam de ferramentas de compilação para o destino. Metadados corretos não garantem binários corretos.
Depois de confirmar a variante, você pode fixá-la:
services:
app:
image: yourname/myapp:2026-10-23-amd64
platform: linux/amd64
restart: unless-stopped
Compose platform seleciona plataforma e variante. Não transforma binários ARM nem instala emulação. Forçar AMD64 em ARM pode exigir emulador; prefira nativo em produção quando possível.
Confira projeto original, ambiente, montagens e backup antes da manutenção:
docker compose config --quiet
docker compose pull app
docker compose up -d --no-deps app
docker compose ps app
Os comandos pressupõem diretório real e dependências funcionando. Preserve -f, --env-file e nome do projeto. restart não aplica imagem nova; veja mudanças Compose não aplicadas. Confirme dados montados e com backup antes de recriar; não precisa apagar volumes.
Examine o arquivo fonte:
file entrypoint.sh
head -n 1 entrypoint.sh
od -An -tx1 -N32 entrypoint.sh
Um script executado diretamente precisa de linha inicial como #!/bin/sh e do interpretador presente. Trocar Bash por sh na primeira linha não adapta sintaxe Bash. Veja execve do Linux.
Confira BOM UTF-8, CRLF do Windows e bit de execução. CRLF pode inserir um retorno no caminho do interpretador, causando erro diferente de arquitetura. permission denied exige verificar permissões separadamente. Faça backup, salve com LF sem BOM e valide com o interpretador adequado. Não substitua quebras de linha em lote em arquivos binários.
Se encerra imediatamente, docker exec normalmente não consegue entrar. Examine as fontes; para extrair arquivos da imagem, use um contêiner temporário específico e docker cp. Evite remendos manuais em produção impossíveis de reproduzir pelo código.
Confirme arquitetura do daemon, plataforma da tag e executável interno. Teste uma requisição real e confira logs de formato. Verifique montagens e dados; mantenha tag e configuração anteriores para reverter.
São comandos de diagnóstico, não testes de implantação nas duas arquiteturas. Identifique o arquivo, compare plataforma e examine script e compilação. Adicionar platform sozinho não conclui a correção.