...
Eroare Docker · Docker Compose

invalid project name "Magazin": must consist only of lowercase alphanumeric characters, hyphens, and underscores as well as start with a letter or number

Pe scurt

Numele proiectului Compose (din name: în compose.yaml, din -p sau din COMPOSE_PROJECT_NAME) are litere mari, spații sau alte caractere. Folosește doar litere mici, cifre, cratime și underscore, de exemplu name: magazin.

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

Ce înseamnă

Compose pune numele proiectului în fața tuturor resurselor: containerele devin magazin-db-1, rețeaua magazin_default, volumele magazin_pgdata. Aceste nume trebuie să fie valide pentru Docker, așa că proiectul are voie să conțină doar litere mici, cifre, - și _ și să înceapă cu o literă sau o cifră.

Numele vine, în ordinea priorității, din -p / --project-name, din variabila COMPOSE_PROJECT_NAME, din cheia name: de sus din compose.yaml și, la final, din numele folderului. Când îl dai explicit (primele trei), Compose îl verifică și refuză numele cu majuscule (Magazin), spații (magazin online) sau puncte.

Numele folderului e tratat mai blând: Compose îl transformă singur în litere mici și elimină caracterele nepermise.

De ce apare: cauzele frecvente

1Majuscule în name:

Greșit
BASH
name: Magazin
services:
  web:
    image: nginx:1.27-alpine
Corect
BASH
name: magazin
services:
  web:
    image: nginx:1.27-alpine

Litere mici, deci un nume valid pentru containere, rețele și volume.

2Spațiu în -p

Greșit
BASH
docker compose -p "magazin online" up -d
Corect
BASH
docker compose -p magazin-online up -d

Cratima înlocuiește spațiul.

3Variabilă de mediu uitată

Greșit
BASH
export COMPOSE_PROJECT_NAME=Magazin.Test
docker compose up -d
Corect
BASH
export COMPOSE_PROJECT_NAME=magazin_test
docker compose up -d

Variabila are prioritate peste name: din fișier, deci și ea trebuie să fie validă.

Repară tu

Repară eroarea, direct în pagină

În ~/magazin, compose.yaml începe cu name: Magazin, iar docker compose up -d dă invalid project name "Magazin". Corectează numele proiectului în fișier, ca proiectul să se numească magazin, și pornește-l (serviciul web trebuie să ruleze).

Indiciu

Prima linie devine name: magazin.

Alte forme ale mesajului

  • invalid project name "magazin online": must consist only of lowercase alphanumeric characters, hyphens, and underscores as well as start with a letter or number
  • project name must not be empty

Cum o eviți pe viitor

Pune name: în compose.yaml, cu litere mici și cratime (name: magazin-online), ca proiectul să aibă același nume indiferent de folder. Evită COMPOSE_PROJECT_NAME global în profilul shell-ului, unde e ușor de uitat. Verifică numele cu docker compose config (prima linie, name:) sau docker compose ls.

Întrebări frecvente

De ce numele folderului cu majuscule nu dă eroare?

Când numele vine din folder, Compose îl normalizează automat (litere mici, fără caractere nepermise). Doar numele date explicit sunt verificate strict.

Dacă schimb numele proiectului, ce se întâmplă cu datele?

Volumele au prefixul proiectului, deci un nume nou înseamnă volume noi, goale. Volumele vechi rămân, sub numele vechi, până le ștergi.

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.