...
Eroare Docker · Pornirea și gestionarea containerelor

OCI runtime exec failed: exec failed: unable to start container process: exec: "bash": executable file not found in $PATH: unknown

Pe scurt

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

Greșit
BASH
docker exec -it web bash
Corect
BASH
docker exec -it web sh

Alpine are doar sh (BusyBox). Pentru comenzi simple și explorare, sh ajunge.

2Unealta lipsește din imagine

Greșit
BASH
docker exec api curl localhost:3000
Corect
BASH
docker exec api wget -qO- localhost:3000
# sau, temporar, în Alpine:
docker exec api apk add --no-cache curl

Imaginile 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ă

Greșit
BASH
docker run -it alpine bash
Corect
BASH
docker run -it alpine sh

Tot ce scrii după numele imaginii înlocuiește CMD. Dacă programul nu există, containerul nu poate porni (cod 127).

Repară tu

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

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: unknown
  • exec: "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

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