exec /usr/local/bin/docker-entrypoint.sh: exec format error
Programul din container e compilat pentru alt procesor: de obicei imaginea a fost construită pe un Mac cu cip Apple (arm64) și rulează pe un server Intel/AMD (amd64), sau invers. Construiește imaginea pentru platforma serverului: docker build --platform linux/amd64 -t app:1.0 .
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
„Exec format error” vine din kernelul Linux: fișierul pe care containerul încearcă să-l pornească nu e un executabil pe care procesorul acesta să-l poată rula. Containerul se oprește imediat, de obicei cu codul 1 sau 255, iar docker logs conține doar linia aceasta.
Cauza clasică este arhitectura: imaginile au variante pentru linux/amd64 (Intel/AMD) și linux/arm64 (Mac cu M1–M4, Raspberry Pi, servere Graviton). Un build făcut pe un Mac ARM produce implicit o imagine arm64; urcată pe un server amd64, binarele din ea (node, python, scriptul tău compilat) nu pot rula. Docker afișează uneori și un avertisment: The requested image's platform (linux/arm64) does not match the detected host platform (linux/amd64).
O a doua cauză, mai rară: un script de intrare fără linia #!/bin/sh la început, pe care kernelul nu știe cum să-l pornească.
De ce apare: cauzele frecvente
1Imagine construită pe ARM, rulată pe amd64
# pe un Mac M2
docker build -t ana/api:1.0 .
docker push ana/api:1.0
# pe server: exec format errordocker build --platform linux/amd64 -t ana/api:1.0 .
docker push ana/api:1.0Cu --platform, build-ul folosește varianta amd64 a imaginii de bază și produce binare pentru procesorul serverului.
2Script de intrare fără shebang
# start.sh
echo "Pornesc"
exec node server.js#!/bin/sh
echo "Pornesc"
exec node server.jsLa ENTRYPOINT ["/start.sh"], kernelul se uită la primele caractere ale fișierului ca să știe cu ce să-l ruleze. Fără #!/bin/sh, nu-l poate executa.
3Binar compilat pentru alt sistem
# compilat pe macOS
COPY ./server /usr/local/bin/serverFROM golang:1.23 AS build
WORKDIR /src
COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build -o /server
FROM alpine:3.20
COPY --from=build /server /usr/local/bin/serverUn executabil pentru macOS sau Windows nu rulează în Linux. Compilarea în imagine (multi-stage) produce un binar Linux.
Repară eroarea, direct în pagină
Imaginea catalog-api construită pe laptopul cu procesor ARM dă pe serverul de producție (Intel, linux/amd64) eroarea exec /usr/local/bin/docker-entrypoint.sh: exec format error. În ~/catalog, construiește catalog-api:1.3 cu platforma linux/amd64 setată explicit și verifică arhitectura imaginii cu docker image inspect.
Indiciu
docker build --platform linux/amd64 …; arhitectura se citește cu -f '{{.Os}}/{{.Architecture}}'.
Reparația
Build pentru platforma serverului și verificarea arhitecturii:
docker build --platform linux/amd64 -t catalog-api:1.3 .
docker image inspect -f '{{.Os}}/{{.Architecture}}' catalog-api:1.3linux/amd64Pentru ambele arhitecturi deodată (în registry): docker buildx build --platform linux/amd64,linux/arm64 -t ana/catalog-api:1.3 --push .
De ce merge
Opțiunea --platform linux/amd64 îi cere lui BuildKit să folosească varianta amd64 a imaginii de bază node:20-alpine și să ruleze pașii pentru acea arhitectură, deci executabilul node din imagine e compilat pentru procesoarele Intel/AMD ale serverului. docker image inspect confirmă linux/amd64 înainte să publici imaginea, așa că nu mai afli de problemă abia la pornirea pe server.
Alte forme ale mesajului
exec /app/start.sh: exec format errorstandard_init_linux.go:228: exec user process caused: exec format errorWARNING: The requested image's platform (linux/arm64/v8) does not match the detected host platform (linux/amd64/v3) and no specific platform was requested
Cum o eviți pe viitor
Setează explicit platforma în build-urile pentru servere (--platform linux/amd64, sau platform: linux/amd64 în compose.yaml) și verifică arhitectura înainte de publicare cu docker image inspect -f '{{.Os}}/{{.Architecture}}' imagine. Pentru imagini folosite pe ambele tipuri de procesoare, publică o imagine multi-platformă cu docker buildx build --platform linux/amd64,linux/arm64 --push. Cel mai sigur e să construiești imaginile de producție în CI, pe aceeași arhitectură ca serverele.
Întrebări frecvente
Cum aflu pentru ce arhitectură e o imagine?
docker image inspect -f '{{.Os}}/{{.Architecture}}' imagine pentru o imagine locală. Arhitectura calculatorului tău o vezi cu docker info (rândul Architecture) sau uname -m.
Pe Mac merge și imaginea amd64. De ce?
Docker Desktop poate emula amd64 pe procesoarele ARM (prin Rosetta sau QEMU), mai încet. Serverele Linux obișnuite nu fac emulare implicit, de aceea eroarea apare abia acolo.
Erori înrudite
Error response from daemon: manifest for nginx:1.99 not found: manifest unknown: manifest unknown Imaginea există pe registry, dar tagul cerut (aici 1.99) nu. Alege un tag care există, de exemplu nginx:1.27 sau nginx:alpine, după lista de taguri de pe pagina imaginii; la imaginile tale, verifică dacă ai urcat chiar tagul pe care îl ceri. OCI runtime exec failed: exec failed: unable to start container process: exec: "bash": executable file not found in $PATH: unknown Imaginea nu are bash: imaginile alpine și cele minimale au doar sh. Folosește docker exec -it nume sh în loc de bash (sau instalează bash în imagine, dacă chiar ai nevoie). Containerul se oprește imediat după pornire: Exited (1) Exited (1) înseamnă că aplicația din container a pornit și a crăpat cu o eroare. Citește motivul cu docker logs nume: de obicei e o cale greșită în CMD, un fișier sau un modul lipsă, o variabilă de mediu obligatorie nesetată sau o eroare în cod. Învață Docker de la zero, cu exerciții la fiecare lecție
Curs Docker: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
