...
Eroare Docker · Rețele, porturi și volume

Error response from daemon: create ./date: "./date" includes invalid characters for a local volume name, only "[a-zA-Z0-9][a-zA-Z0-9_.-]" are allowed. If you intended to pass a host directory, use absolute path

Pe scurt

Docker a înțeles textul dat ca nume de volum, iar numele conține caractere nepermise (/, spațiu, ~ nefolosit de shell). Pentru un volum folosește un nume simplu (date-magazin); pentru un folder de pe calculator dă o cale absolută: -v "$(pwd)/date:/data" sau -v ~/date:/data.

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

Ce înseamnă

Partea din stânga lui -v SURSA:DESTINATIE poate fi două lucruri: un nume de volum (ex. pgdata) sau o cale pe calculator (bind mount). Docker decide după formă: o cale absolută (/home/ana/date) e bind mount, orice altceva e tratat ca nume de volum. Numele de volum pot avea doar litere, cifre, _, . și -, deci ./date, date vechi sau C:proiect sunt refuzate, iar mesajul îți sugerează calea absolută.

Unde apare:

  • docker volume create ./date, când voiai un volum numit;
  • docker run -v ./date:/data pe versiuni Docker mai vechi de 23, care nu acceptau căi relative;
  • -v "$PWD"/date:/data cu un $PWD care conține spații, nepus între ghilimele;
  • ~ între ghilimele ("~/date:/data"), pe care shell-ul nu-l mai transformă în /home/....

De ce apare: cauzele frecvente

1Cale dată la docker volume create

Greșit
BASH
docker volume create ./date-magazin
Corect
BASH
docker volume create date-magazin

Un volum numit primește doar un nume; Docker îi alege singur locul pe disc.

2Cale relativă pe Docker vechi

Greșit
BASH
docker run -d -v ./date:/data nginx
Corect
BASH
docker run -d -v "$(pwd)/date:/data" nginx

Calea absolută e recunoscută ca bind mount pe orice versiune.

3Tilda între ghilimele

Greșit
BASH
docker run -d -v "~/date:/data" nginx
Corect
BASH
docker run -d -v ~/date:/data nginx

Între ghilimele, ~ rămâne literal, iar Docker îl ia drept nume de volum.

Repară tu

Repară eroarea, direct în pagină

Vrei un volum Docker pentru datele Redis ale magazinului, dar docker volume create ./date-magazin dă includes invalid characters for a local volume name. Creează volumul numit date-magazin și pornește containerul cache din redis:7 cu volumul montat în /data.

Indiciu

Un volum numit primește doar un nume, fără ./ în față.

Alte forme ale mesajului

  • docker: Error response from daemon: create ./date: "./date" includes invalid characters for a local volume name, only "[a-zA-Z0-9][a-zA-Z0-9_.-]" are allowed. If you intended to pass a host directory, use absolute path.
  • Error response from daemon: create date vechi: "date vechi" includes invalid characters for a local volume name, only "[a-zA-Z0-9][a-zA-Z0-9_.-]" are allowed
  • docker: Error response from daemon: create ~/date: "~/date" includes invalid characters for a local volume name

Cum o eviți pe viitor

Alege din start ce vrei: date gestionate de Docker (volum numit, -v pgdata:/var/lib/postgresql/data) sau fișiere de pe calculator (bind mount, cu cale absolută). Pentru bind mount-uri, sintaxa --mount type=bind,src="$(pwd)"/date,dst=/data e mai explicită și dă erori clare. Pune mereu căile cu variabile între ghilimele.

Întrebări frecvente

Unde stau fizic datele unui volum numit?

În zona Docker-ului, de obicei /var/lib/docker/volumes/NUME/_data pe Linux (în mașina virtuală, la Docker Desktop). Le vezi calea cu docker volume inspect NUME.

În compose.yaml merg căile relative?

Da. Compose transformă ./date în cale absolută, relativ la folderul fișierului compose.yaml, înainte să trimită cererea la daemon.

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.