...
Eroare Docker · Pornirea și gestionarea containerelor

docker: Error response from daemon: Invalid container name (magazin web), only [a-zA-Z0-9][a-zA-Z0-9_.-] are allowed.

Pe scurt

Numele dat cu --name conține caractere nepermise (spațiu, diacritice, /, :) sau începe cu - ori _. Un nume de container poate avea doar litere, cifre, _ . și -, și trebuie să înceapă cu literă sau cifră: --name magazin-web.

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

Ce înseamnă

Regula din mesaj e o expresie regulată: primul caracter trebuie să fie literă sau cifră ([a-zA-Z0-9]), iar restul pot fi litere, cifre, _, . sau -. Orice altceva (spațiu, ă, ș, /, :, @) face numele invalid, iar containerul nu se creează.

Cauzele frecvente: un spațiu în nume (--name "magazin web"), diacritice (--name cafenea-brașov), numele imaginii folosit ca nume de container (--name nginx:1.27), sau un nume construit dintr-o variabilă care conține caractere nepotrivite, de exemplu numele unui branch git (feature/login).

Între paranteze, mesajul arată exact numele primit de daemon, deci vezi imediat caracterul problematic.

De ce apare: cauzele frecvente

1Spațiu în nume

Greșit
BASH
docker run -d --name "magazin web" nginx
Corect
BASH
docker run -d --name magazin-web nginx

Spațiul nu e permis; cratima sau underscore-ul separă cuvintele.

2Diacritice sau două puncte

Greșit
BASH
docker run -d --name nginx:1.27 nginx:1.27
Corect
BASH
docker run -d --name nginx-127 nginx:1.27

: separă tag-ul în numele imaginilor; în numele containerelor nu e permis.

3Nume din branch-ul git

Greșit
BASH
docker run -d --name "api-$BRANCH" api   # feature/login
Corect
BASH
docker run -d --name "api-$(echo "$BRANCH" | tr '/' '-')" api

/ din numele branch-ului e înlocuit cu -, care e permis.

Repară tu

Repară eroarea, direct în pagină

Vrei să pornești magazinul online cu docker run -d --name "magazin web" -p 8080:80 nginx:1.27-alpine, dar comanda cade cu Invalid container name (magazin web). Pornește containerul cu numele magazin-web, pe portul 8080, și verifică pagina.

Indiciu

Înlocuiește spațiul din nume cu o cratimă.

Alte forme ale mesajului

  • Error response from daemon: Invalid container name (cafenea-brașov), only [a-zA-Z0-9][a-zA-Z0-9_.-] are allowed
  • Error response from daemon: Invalid container name (nginx:1.27), only [a-zA-Z0-9][a-zA-Z0-9_.-] are allowed

Cum o eviți pe viitor

Alege nume scurte, fără spațiu și diacritice, cu cratimă între cuvinte: magazin-web, magazin-db. În scripturi, curăță numele generate din variabile (branch, utilizator) înainte să le folosești. În Compose, numele se construiesc automat din proiect și serviciu, deci evită spațiile și în numele folderului.

Întrebări frecvente

Pot folosi litere mari în numele containerului?

Da, numele containerelor acceptă litere mari (MagazinWeb). Numele imaginilor, în schimb, trebuie să fie cu litere mici.

De ce în docker inspect numele începe cu /?

Intern, Docker păstrează numele cu / în față (/magazin-web), dintr-o convenție veche. Tu îl scrii fără / în comenzi.

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.