...
Eroare Docker · Pornirea și gestionarea containerelor

docker: Error response from daemon: unable to find user app: no matching entries in passwd file.

Pe scurt

Utilizatorul dat la -u sau la USER în Dockerfile nu există în /etc/passwd al imaginii. Creează-l în Dockerfile (RUN addgroup -S app && adduser -S -G app app) înainte de USER, sau folosește un utilizator existent (node, nobody) ori un uid numeric.

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

Ce înseamnă

Când pornești un container cu -u app sau imaginea are USER app, Docker caută numele app în fișierul /etc/passwd din imagine, nu de pe calculatorul tău. Dacă nu-l găsește, containerul nu poate porni: rămâne în starea Created, iar docker run iese cu codul 125.

Cauzele obișnuite: ai scris USER app în Dockerfile, dar ai uitat (sau ai pus după) comanda care creează utilizatorul; ai folosit un nume care există pe calculatorul tău, dar nu în imagine; ai trecut la altă imagine de bază (de la node, care are utilizatorul node, la alpine, care nu-l are).

Un uid numeric (-u 1000) nu dă eroarea asta: Docker îl folosește chiar dacă n-are nume, iar în container vezi I have no name! în prompt.

De ce apare: cauzele frecvente

1USER fără crearea utilizatorului

Greșit
BASH
FROM node:20-alpine
WORKDIR /app
COPY . .
USER app
CMD ["node", "server.js"]
Corect
BASH
FROM node:20-alpine
WORKDIR /app
COPY . .
RUN addgroup -S app && adduser -S -G app app
USER app
CMD ["node", "server.js"]

Utilizatorul trebuie să existe în imagine înainte de USER. Pe Alpine îl creezi cu addgroup și adduser -S (fără parolă).

2Utilizatorul există pe calculator, nu în imagine

Greșit
BASH
docker run -u ana alpine id
Corect
BASH
docker run -u 1000:1000 alpine id

Containerul are propriul /etc/passwd. Un uid numeric merge și fără nume în imagine.

3Imaginea are deja un utilizator neprivilegiat

Greșit
BASH
FROM node:20-alpine
USER nodeuser
Corect
BASH
FROM node:20-alpine
USER node

Imaginea oficială node include utilizatorul node (uid 1000), gata de folosit.

Repară tu

Repară eroarea, direct în pagină

În ~/api, Dockerfile-ul setează USER app, dar nu creează utilizatorul, iar containerul nu pornește: unable to find user app. Repară Dockerfile-ul ca să creeze grupul și utilizatorul de sistem app înainte de USER, reconstruiește api:1.1 și rulează containerul api din el, care trebuie să afișeze API pornit și să ruleze ca app.

Indiciu

Pe Alpine: RUN addgroup -S app && adduser -S -G app app, pus înainte de linia USER app.

Alte forme ale mesajului

  • unable to find user app: no matching entries in passwd file
  • docker: Error response from daemon: unable to find group app: no matching entries in group file.

Cum o eviți pe viitor

Creează utilizatorul și grupul în același Dockerfile, chiar înainte de USER (Alpine: addgroup -S app && adduser -S -G app app; Debian: useradd -r -s /usr/sbin/nologin app). Verifică după build cu docker run --rm imagine id. Când schimbi imaginea de bază, revizuiește liniile USER și chown: utilizatorii predefiniți diferă de la o imagine la alta.

Întrebări frecvente

De ce containerul apare Created, nu Exited?

Pentru că eroarea apare înainte de pornirea procesului principal. Containerul a fost creat, dar n-a rulat niciodată, deci nu are cod de ieșire al aplicației.

E mai bine cu nume sau cu uid?

Numele e mai lizibil în Dockerfile, uid-ul e mai previzibil la permisiunile volumelor. Multe echipe creează utilizatorul cu uid fix (adduser -S -u 10001 app) și pun USER 10001.

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.