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).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Docker a încercat să pornească în container programul bash și nu l-a găsit în niciun folder din PATH. Partea OCI runtime exec failed arată că eroarea vine de la runtime-ul care pornește procesele (runc), iar executable file not found in $PATH e motivul.
Imaginile bazate pe Alpine (nginx:alpine, node:20-alpine, python:3.12-alpine, redis:7-alpine) folosesc BusyBox și au doar sh. Imaginile distroless sau cele construite FROM scratch nu au niciun shell. Debian și Ubuntu au bash.
Același mesaj apare și pentru alte programe lipsă (ps, curl, ping), iar la docker run imagine bash arată puțin diferit (failed to create task for container, cod 127). Ideea e aceeași: comanda ta nu există în imagine.
De ce apare: cauzele frecvente
1Imagine Alpine, fără bash
docker exec -it web bashdocker exec -it web shAlpine are doar sh (BusyBox). Pentru comenzi simple și explorare, sh ajunge.
2Unealta lipsește din imagine
docker exec api curl localhost:3000docker exec api wget -qO- localhost:3000
# sau, temporar, în Alpine:
docker exec api apk add --no-cache curlImaginile mici nu includ curl. BusyBox are wget; instalarea în container se pierde la recreare, deci pentru folosire permanentă pui unealta în Dockerfile.
3La docker run, comanda de după imagine nu există
docker run -it alpine bashdocker run -it alpine shTot ce scrii după numele imaginii înlocuiește CMD. Dacă programul nu există, containerul nu poate porni (cod 127).
Repară eroarea, direct în pagină
Serverul web (nginx:1.27-alpine, pe portul 8080) rulează, iar docker exec -it web bash dă exec: "bash": executable file not found in $PATH. Folosește shell-ul care există în imagine ca să creezi fișierul /usr/share/nginx/html/sanatate.html cu textul ok, apoi verifică pagina cu curl localhost:8080/sanatate.html.
Indiciu
În Alpine shell-ul se numește sh; o comandă scurtă o rulezi cu docker exec web sh -c '…'.
Reparația
Imaginea Alpine are sh, nu bash:
docker exec web sh -c 'echo ok > /usr/share/nginx/html/sanatate.html'
curl -s localhost:8080/sanatate.htmlokDe ce merge
Imaginea nginx:1.27-alpine e construită pe Alpine, care are doar sh (BusyBox), nu bash. docker exec web sh -c 'echo ok > …' pornește shell-ul care există și scrie fișierul în folderul servit de nginx, deci pagina răspunde imediat. Pentru o sesiune interactivă ai fi folosit docker exec -it web sh.
Alte forme ale mesajului
docker: Error response from daemon: failed to create task for container: failed to create shim task: OCI runtime create failed: runc create failed: unable to start container process: exec: "bash": executable file not found in $PATH: unknown.OCI runtime exec failed: exec failed: unable to start container process: exec: "curl": executable file not found in $PATH: unknownexec: "bash": executable file not found in $PATH
Cum o eviți pe viitor
Află ce bază are imaginea înainte să intri în ea: tagul conține de obicei alpine, slim sau bookworm, iar docker exec nume cat /etc/os-release îți spune sigur. Folosește din obișnuință sh, care există aproape peste tot. Uneltele de care ai nevoie mereu (curl pentru healthcheck, de exemplu) le instalezi în Dockerfile (RUN apk add --no-cache curl), nu manual în containerul pornit.
Întrebări frecvente
Pot instala bash în Alpine?
Da: apk add --no-cache bash, în Dockerfile ca să rămână. De obicei nu merită: sh face aproape tot ce îți trebuie la depanare.
De ce codul de ieșire e 127 (sau 126 la exec)?
127 este codul standard pentru „comandă negăsită” în shell-urile Unix, iar Docker îl păstrează la docker run. La docker exec, clientul întoarce 126 sau 127 în funcție de versiune.
Erori înrudite
Error response from daemon: container 3f2a1b4c5d6e... is not running docker exec merge doar într-un container pornit, iar al tău e oprit (Exited). Pornește-l cu docker start nume și apoi rulează exec; dacă se oprește iar imediat, citește motivul cu docker logs nume. 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 . 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.
