...
Eroare Docker · Containere care se opresc imediat

npm error Missing script: "start"

Pe scurt

CMD ["npm", "start"] rulează scriptul start din package.json, dar acolo nu există. Adaugă-l în scripts ("start": "node server.js") și reconstruiește imaginea, sau pornește direct aplicația: CMD ["node", "server.js"].

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

Ce înseamnă

npm start nu pornește magic aplicația: caută în package.json cheia scripts.start și rulează comanda de acolo. Dacă nu o găsește, npm afișează Missing script: "start", sugerează npm run ca să vezi scripturile existente și iese cu cod 1. Containerul se oprește imediat, iar mesajul apare în docker logs.

Cauze frecvente: proiectul are doar dev (de exemplu pentru nodemon) sau serve; scriptul e scris în alt loc din package.json (în afara lui scripts); în imagine a ajuns alt package.json (din alt folder, sau unul vechi, din cache); ori WORKDIR diferă de folderul cu package.json, iar npm citește alt fișier.

Cu docker run --rm imagine cat package.json vezi exact fișierul din imagine.

De ce apare: cauzele frecvente

1Scriptul start lipsește

Greșit
BASH
"scripts": { "dev": "nodemon server.js" }
Corect
BASH
"scripts": { "start": "node server.js", "dev": "nodemon server.js" }

npm start rulează doar scripts.start.

2Alt nume de script în CMD

Greșit
BASH
CMD ["npm", "start"]   # package.json are doar "serve"
Corect
BASH
CMD ["npm", "run", "serve"]

Scripturile în afară de start, test și câteva standard se rulează cu npm run nume.

3Pornire directă, fără npm

Greșit
BASH
CMD ["npm", "start"]
Corect
BASH
CMD ["node", "server.js"]

Fără npm la mijloc, procesul principal e node, care primește direct semnalele de oprire.

Repară tu

Repară eroarea, direct în pagină

API-ul din ~/api are în package.json doar scriptul dev, iar Dockerfile-ul pornește cu CMD ["npm", "start"]. Containerul api se oprește imediat cu npm error Missing script: "start". Adaugă scriptul start (node server.js), reconstruiește api:1.0 și pornește din nou api pe portul 3000.

Indiciu

În scripts din package.json, adaugă "start": "node server.js".

Alte forme ale mesajului

  • npm ERR! Missing script: "start"
  • npm error Missing script: "dev"
  • npm ERR! missing script: start

Cum o eviți pe viitor

Pune în package.json un script start care pornește aplicația în producție și testează imaginea local cu docker run --rm imagine înainte să o publici. Verifică scripturile din imagine cu docker run --rm imagine npm run. Mulți preferă CMD ["node", "server.js"], fără npm, ca semnalele de oprire să ajungă direct la aplicație.

Întrebări frecvente

Dacă nu există scripts.start, npm nu încearcă node server.js?

Da, dar doar când există un fișier server.js în folder și lipsește complet scripts.start. Dacă fișierul tău se numește altfel (index.js, src/app.js), primești această eroare.

Am adăugat scriptul, dar eroarea rămâne. De ce?

Containerul pornește din imaginea veche. Reconstruiește imaginea (docker build), șterge containerul vechi și pornește-l din nou din imaginea nouă.

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.