...
Eroare Docker · Dockerfile și docker build

ERROR: failed to solve: dockerfile parse error on line 3: unknown instruction: COPPY (did you mean copy?)

Pe scurt

Pe linia indicată, primul cuvânt nu e o instrucțiune Dockerfile validă: e o greșeală de scriere (COPPY, RUNN) sau o linie care continuă comanda de deasupra fără backslash. Corectează linia 3, după sugestia did you mean.

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

Ce înseamnă

Fiecare linie dintr-un Dockerfile începe cu o instrucțiune: FROM, RUN, COPY, ADD, WORKDIR, ENV, ARG, EXPOSE, USER, CMD, ENTRYPOINT, HEALTHCHECK, LABEL, VOLUME și altele câteva. Parser-ul citește fișierul înainte de orice pas al build-ului și se oprește la primul cuvânt necunoscut, cu numărul liniei și, de obicei, o sugestie (did you mean copy?).

În afară de greșelile de scriere, eroarea apare des la comenzile lungi rupte pe mai multe rânduri: dacă uiți \ la finalul unui rând dintr-un RUN, rândul următor (de exemplu curl \) e citit ca instrucțiune nouă, deci unknown instruction: CURL. Majusculele nu contează (run merge), dar convenția e să le scrii cu litere mari.

Blocul cu >>> de deasupra mesajului arată exact linia problematică.

De ce apare: cauzele frecvente

1Instrucțiune scrisă greșit

Greșit
BASH
FROM nginx:1.27-alpine
COPPY index.html /usr/share/nginx/html/
Corect
BASH
FROM nginx:1.27-alpine
COPY index.html /usr/share/nginx/html/

COPPY nu există; parser-ul se oprește la ea. COPY e instrucțiunea corectă.

2Lipsește backslash-ul într-un RUN pe mai multe rânduri

Greșit
BASH
RUN apt-get update && apt-get install -y
    curl git
Corect
BASH
RUN apt-get update && apt-get install -y \
    curl git

Fără \ la final, rândul al doilea e o instrucțiune nouă, iar CURL nu există.

3Comandă de shell scrisă direct

Greșit
BASH
FROM node:20-alpine
npm install
Corect
BASH
FROM node:20-alpine
RUN npm install

Comenzile de shell se rulează în Dockerfile doar prin RUN.

Repară tu

Repară eroarea, direct în pagină

În ~/cafenea, build-ul docker build -t cafenea:1.0 . se oprește cu dockerfile parse error on line 3: unknown instruction: COPPY. Repară linia din Dockerfile (în tabul Dockerfile sau cu sed), construiește imaginea cafenea:1.0 și verifică că pagina a ajuns în imagine.

Indiciu

Instrucțiunea care copiază fișiere în imagine se scrie COPY.

Alte forme ale mesajului

  • ERROR: failed to solve: dockerfile parse error on line 4: unknown instruction: RUNN (did you mean run?)
  • ERROR: failed to solve: dockerfile parse error on line 5: unknown instruction: CURL
  • Error response from daemon: dockerfile parse error line 3: unknown instruction: COPPY

Cum o eviți pe viitor

Scrie Dockerfile-urile într-un editor cu suport pentru Docker (VS Code cu extensia Docker), care subliniază instrucțiunile necunoscute. Rulează hadolint Dockerfile înainte de commit, pentru greșeli și bune practici. La comenzile RUN lungi, pune câte un pachet pe rând și verifică să existe \ la finalul fiecărui rând, mai puțin ultimul.

Întrebări frecvente

Instrucțiunile trebuie scrise cu majuscule?

Nu, copy și COPY sunt la fel pentru parser. Majusculele sunt doar o convenție, ca să se distingă instrucțiunile de argumente.

Build-ul se oprește înainte de orice pas. E normal?

Da. Dockerfile-ul e citit și validat în întregime înainte de primul pas, deci o greșeală de sintaxă oprește build-ul imediat, oricât de jos ar fi.

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.