...
Eroare Docker · Docker Compose

validating /home/ana/magazin/compose.yaml: (root) Additional property service is not allowed

Pe scurt

La primul nivel din compose.yaml ai o cheie pe care Compose nu o cunoaște: de obicei service în loc de services, volume în loc de volumes sau un serviciu scris fără indentare. La rădăcină sunt permise doar services, volumes, networks, configs, secrets, name, include și x-...

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

Ce înseamnă

Compose validează fișierul după o schemă. (root) înseamnă primul nivel al fișierului, fără indentare. Additional property service is not allowed spune că acolo a găsit cheia service, care nu face parte din schemă.

Cheile valide la rădăcină sunt services, volumes, networks, configs, secrets, name, include, version (învechită) și extensiile care încep cu x-. Orice altceva e respins: singularul (service, volume, network), o greșeală de scriere (sevices), un serviciu (db:) lipit la marginea din stânga în loc să fie indentat sub services:, sau o cheie de serviciu (ports:) care a pierdut indentarea.

Pe versiuni mai noi de Compose, mesajul poate apărea ca additional properties 'service' not allowed. Cheia din mesaj îți arată exact linia problematică.

De ce apare: cauzele frecvente

1Singular în loc de plural

Greșit
BASH
service:
  web:
    image: nginx
Corect
BASH
services:
  web:
    image: nginx

Cheia de la rădăcină e services, la plural.

2Serviciu neindentat

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

Fără indentare, db ajunge la rădăcină, nu sub services.

3volume în loc de volumes

Greșit
BASH
volume:
  pgdata:
Corect
BASH
volumes:
  pgdata:

Secțiunea de volume de la rădăcină se numește volumes.

Repară tu

Repară eroarea, direct în pagină

În ~/magazin, docker compose up -d se oprește cu (root) Additional property service is not allowed. Repară cheia de la începutul fișierului compose.yaml, astfel încât serviciul web (nginx, portul 8080) să fie recunoscut, și pornește proiectul.

Indiciu

Cheia sub care stau serviciile se scrie la plural.

Alte forme ale mesajului

  • validating /home/ana/magazin/compose.yaml: (root) additional properties 'service' not allowed
  • validating /home/ana/magazin/compose.yaml: (root) Additional property db is not allowed
  • (root) Additional property volume is not allowed

Cum o eviți pe viitor

Pornește de la un compose.yaml care merge și modifică-l pas cu pas. Folosește un editor cu extensia pentru Docker Compose (validează după schemă și completează cheile) și indentare cu spații, de câte 2. Rulează docker compose config după fiecare modificare: arată fișierul interpretat sau eroarea exactă.

Întrebări frecvente

De ce mesajul zice 'Additional property'?

Schema Compose listează cheile permise la fiecare nivel. Orice cheie în plus e „o proprietate suplimentară”, respinsă ca să prindă greșelile de scriere.

Pot adăuga chei proprii în fișier?

Da, dacă încep cu x- (de exemplu x-comun:). Le folosești pentru blocuri reutilizabile, cu ancore YAML.

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.