...
Eroare Docker · Dockerfile și docker build

exec /usr/local/bin/docker-entrypoint.sh: exec format error

Pe scurt

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

Greșit
BASH
# pe un Mac M2
docker build -t ana/api:1.0 .
docker push ana/api:1.0
# pe server: exec format error
Corect
BASH
docker build --platform linux/amd64 -t ana/api:1.0 .
docker push ana/api:1.0

Cu --platform, build-ul folosește varianta amd64 a imaginii de bază și produce binare pentru procesorul serverului.

2Script de intrare fără shebang

Greșit
BASH
# start.sh
echo "Pornesc"
exec node server.js
Corect
BASH
#!/bin/sh
echo "Pornesc"
exec node server.js

La 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

Greșit
BASH
# compilat pe macOS
COPY ./server /usr/local/bin/server
Corect
BASH
FROM 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/server

Un executabil pentru macOS sau Windows nu rulează în Linux. Compilarea în imagine (multi-stage) produce un binar Linux.

Repară tu

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}}'.

Alte forme ale mesajului

  • exec /app/start.sh: exec format error
  • standard_init_linux.go:228: exec user process caused: exec format error
  • WARNING: 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

← Toate erorile Docker

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.