...
Eroare Docker · Docker Compose

service "web" has neither an image nor a build context specified: invalid compose project

Pe scurt

Serviciul din compose.yaml nu spune de unde vine containerul: n-are nici image:, nici build:. Adaugă image: nginx:1.27-alpine (o imagine existentă) sau build: . (construiește din Dockerfile-ul proiectului); verifică și indentarea, poate image e sub alt serviciu.

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

Ce înseamnă

Fiecare serviciu are nevoie de o imagine: fie una gata făcută (image: postgres:16), fie una construită de Compose dintr-un Dockerfile (build: ./api). Dacă lipsesc amândouă, Compose nu are din ce crea containerul și respinge proiectul întreg (invalid compose project).

De obicei cheia nu lipsește de tot, ci e în locul greșit: indentată sub alt serviciu, sub ports:, scrisă greșit (imagine:, img:, pe care Compose le raportează altfel) sau rămasă într-un fișier override pe care nu-l mai incluzi.

docker compose config arată fișierul așa cum îl înțelege Compose și te ajută să vezi unde a ajuns de fapt cheia.

De ce apare: cauzele frecvente

1Lipsește image

Greșit
BASH
services:
  web:
    ports:
      - "8080:80"
Corect
BASH
services:
  web:
    image: nginx:1.27-alpine
    ports:
      - "8080:80"

image spune ce imagine folosește containerul serviciului.

2Voiai să construiești din Dockerfile

Greșit
BASH
services:
  api:
    ports:
      - "3000:3000"
Corect
BASH
services:
  api:
    build: ./api
    ports:
      - "3000:3000"

build indică folderul cu Dockerfile-ul; Compose construiește imaginea la up.

3image indentat sub alt serviciu

Greșit
BASH
services:
  web:
  db:
    image: postgres:16
    image: nginx
Corect
BASH
services:
  web:
    image: nginx:1.27-alpine
  db:
    image: postgres:16

Indentarea decide cărui serviciu îi aparține cheia.

Repară tu

Repară eroarea, direct în pagină

În ~/site, docker compose up -d dă service "web" has neither an image nor a build context specified. Serviciul web trebuie să ruleze nginx din imaginea nginx:1.27-alpine pe portul 8080. Repară compose.yaml, pornește proiectul și verifică pagina pe localhost:8080.

Indiciu

Sub web:, la același nivel cu ports:, adaugă image: nginx:1.27-alpine.

Alte forme ale mesajului

  • service "api" has neither an image nor a build context specified: invalid compose project
  • Service web has neither an image nor a build context specified. At least one must be provided.

Cum o eviți pe viitor

Pentru fiecare serviciu nou, scrie întâi image: sau build:, apoi restul cheilor. Folosește un editor cu suport YAML, care arată indentarea și semnalează cheile necunoscute. Rulează docker compose config înainte de up: dacă un serviciu nu are imagine, vezi problema fără să pornești nimic.

Întrebări frecvente

Pot avea și image, și build?

Da. Compose construiește din build și dă imaginii numele din image (de exemplu andrei/api:1.0), util când vrei apoi să o urci cu docker compose push.

De ce nu pornește niciun serviciu, deși doar unul are problema?

Compose validează întâi tot proiectul. O greșeală într-un serviciu face proiectul invalid, deci nu pornește nimic până nu o repari.

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.