...
Eroare Docker · Containere care se opresc imediat

Containerul s-a oprit cu Exited (137)

Pe scurt

137 = 128 + 9: procesul principal a fost omorât cu SIGKILL, nu s-a oprit singur. Cauzele: docker kill, docker stop care a așteptat degeaba 10 secunde sau lipsa de memorie (OOMKilled). Verifică cu docker inspect -f '{{.State.OOMKilled}}' nume și, pentru servicii, setează o politică de repornire.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Codurile de ieșire peste 128 înseamnă „omorât de un semnal”: codul minus 128 e numărul semnalului. 137 corespunde lui SIGKILL (9), semnalul care oprește procesul instantaneu, fără să-l lase să facă ceva. (Similar, 143 = SIGTERM, oprire normală cerută.)

Cine trimite SIGKILL: docker kill, docker rm -f, docker stop după ce aplicația n-a răspuns în 10 secunde la SIGTERM, sau kernelul, când containerul a depășit limita de memorie (-m, mem_limit) sau calculatorul a rămas fără memorie. În ultimul caz, docker inspect arată "OOMKilled": true.

Dacă ai oprit tu containerul, 137 e normal. Dacă s-a întâmplat singur, verifică OOMKilled și consumul cu docker stats; pentru servicii, o politică de repornire (unless-stopped) le readuce automat după un crash.

De ce apare: cauzele frecvente

1Containerul a fost oprit forțat

Greșit
BASH
docker kill cache
# Exited (137)
Corect
BASH
docker stop cache   # SIGTERM, oprire curată
docker start cache

docker kill trimite direct SIGKILL. Pentru oprire normală folosește docker stop, care îi dă aplicației timp să se închidă.

2Limita de memorie e prea mică (OOMKilled)

Greșit
BASH
docker run -d --name api -m 64m magazin-api:1.0
Corect
BASH
docker inspect -f '{{.State.OOMKilled}}' api
docker rm api
docker run -d --name api -m 512m magazin-api:1.0

Peste limită, kernelul omoară procesul cu SIGKILL. OOMKilled=true confirmă cauza; mărești limita sau reduci consumul aplicației.

3Aplicația ignoră SIGTERM, iar docker stop expiră

Greșit
BASH
CMD npm start   # forma shell, semnalul nu ajunge la node
Corect
BASH
CMD ["node", "server.js"]

În forma shell, procesul principal e /bin/sh, care nu transmite SIGTERM. După 10 secunde Docker trimite SIGKILL, iar codul devine 137.

Repară tu

Repară eroarea, direct în pagină

Containerul de cache cache (redis:7) apare Exited (137). Află cu docker inspect codul de ieșire și dacă a fost oprit din lipsă de memorie (OOMKilled), pornește-l din nou și setează-i politica de repornire unless-stopped, ca să revină singur după un crash.

Indiciu

docker inspect -f '{{.State.ExitCode}} {{.State.OOMKilled}}' cache; politica o schimbi pe containerul existent cu docker update --restart unless-stopped cache.

Alte forme ale mesajului

  • Exited (137) 5 seconds ago
  • Exited (143) 2 seconds ago
  • "OOMKilled": true

Cum o eviți pe viitor

  • Folosește forma exec la CMD/ENTRYPOINT, ca aplicația să primească SIGTERM și să se oprească singură, curat.
  • Setează limite de memorie realiste și urmărește consumul cu docker stats --no-stream.
  • Pentru servicii, adaugă --restart unless-stopped (sau restart: unless-stopped în compose.yaml).
  • Oprește containerele cu docker stop, nu cu docker kill, mai ales bazele de date.

Întrebări frecvente

Cum aflu sigur dacă a fost lipsă de memorie?

docker inspect -f '{{.State.OOMKilled}} {{.State.ExitCode}}' nume. Dacă vezi true 137, kernelul l-a oprit pentru memorie. false 137 înseamnă un SIGKILL din altă parte, de obicei o comandă docker.

Politica de repornire repornește și un container oprit de mine?

Cu unless-stopped, nu: un container oprit manual rămâne oprit, chiar și după restartul daemon-ului. Cu always, pornește din nou la restartul daemon-ului.

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.