Error saving credentials: error storing credentials - err: exec: "docker-credential-desktop": executable file not found in $PATH, out: ``
~/.docker/config.json cere un credential helper ("credsStore": "desktop") care nu e instalat sau nu e în PATH, de obicei după dezinstalarea Docker Desktop sau în WSL. Scoate linia credsStore din config.json (sau instalează helperul) și rulează din nou docker login.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
La docker login, clientul nu scrie singur parola, ci o dă unui credential helper, un program separat numit docker-credential-<nume>. Numele vine din cheia credsStore din ~/.docker/config.json: desktop înseamnă programul docker-credential-desktop, instalat de Docker Desktop.
Mesajul spune că acel program nu există în PATH. Login-ul e respins chiar dacă parola e bună, iar uneori și docker pull sau docker build dau o eroare asemănătoare la citirea credențialelor (error getting credentials).
Apare tipic după ce ai dezinstalat Docker Desktop și ai pus Docker Engine, când config.json a rămas de la instalarea veche, în WSL fără integrarea Docker Desktop sau pe macOS, când PATH-ul nu include /usr/local/bin. Ori scoți credsStore (credențialele se salvează atunci în config.json), ori instalezi un helper potrivit (pass, secretservice, osxkeychain).
De ce apare: cauzele frecvente
1config.json rămas de la Docker Desktop
cat ~/.docker/config.json
{
"credsStore": "desktop"
}cat > ~/.docker/config.json <<'EOF'
{
"auths": {}
}
EOF
docker login -u andreiFără credsStore, clientul salvează credențialele direct în config.json și nu mai caută helperul lipsă.
2Helperul există, dar nu e în PATH (macOS)
echo $PATH
# lipsește /usr/local/binexport PATH="/usr/local/bin:$PATH"
docker loginDocker Desktop pune docker-credential-desktop în /usr/local/bin. Clientul îl caută doar în PATH.
3WSL fără integrarea Docker Desktop
# în Ubuntu din WSL
docker login# Docker Desktop > Settings > Resources > WSL integration
# sau scoate credsStore din ~/.docker/config.jsonÎn WSL, helperul Docker Desktop e disponibil doar cu integrarea activată pentru distribuție.
Repară eroarea, direct în pagină
După ce ai trecut de la Docker Desktop la Docker Engine, docker login dă error storing credentials - err: exec: "docker-credential-desktop": executable file not found. Repară ~/.docker/config.json ca să nu mai ceară helperul desktop (păstrează un JSON valid, cu "auths": {}), apoi loghează-te ca andrei cu tokenul din ~/token.txt.
Indiciu
Scoate cheia credsStore din fișier, de exemplu rescriindu-l cu un here-document.
Reparația
Fișierul cere un helper care lipsește:
cat ~/.docker/config.json{
"auths": {},
"credsStore": "desktop"
}Rescrie-l fără credsStore și loghează-te:
cat > ~/.docker/config.json <<'EOF'
{
"auths": {}
}
EOF
cat ~/token.txt | docker login -u andrei --password-stdinDe ce merge
Cheia credsStore: desktop îi spune clientului să predea credențialele programului docker-credential-desktop, care nu mai e instalat, așa că login-ul eșua înainte de orice verificare a parolei. După ce o scoți, clientul salvează credențialele direct în config.json, în secțiunea auths, deci login-ul reușește. Restul setărilor din fișier rămân valabile, iar dacă instalezi mai târziu un helper, îl poți adăuga la loc.
Alte forme ale mesajului
Error saving credentials: error storing credentials - err: exec: "docker-credential-desktop.exe": executable file not found in $PATH, out: ``error getting credentials - err: exec: "docker-credential-desktop": executable file not found in $PATH, out: ``Error saving credentials: error storing credentials - err: exit status 1, out: `pass not initialized`
Cum o eviți pe viitor
Când treci de la Docker Desktop la Docker Engine (sau invers), verifică ~/.docker/config.json: cheia credsStore trebuie să numească un helper care există (which docker-credential-desktop). Pe servere și în CI, lasă config.json fără credsStore sau folosește un helper instalat explicit. Fă o copie a fișierului înainte să-l editezi.
Întrebări frecvente
E sigur să scot credsStore?
Funcționează, dar credențialele ajung în config.json codificate base64, nu criptate. Pe un calculator personal e acceptabil cu un token; pe termen lung, instalează un helper (de exemplu docker-credential-pass pe Linux).
De ce crapă și docker pull, nu doar login?
La pull și build, clientul întreabă helperul dacă are credențiale pentru registry. Dacă helperul nu există, cererea eșuează cu error getting credentials, chiar și pentru imagini publice.
Erori înrudite
Error response from daemon: Get "https://registry-1.docker.io/v2/": unauthorized: incorrect username or password Docker Hub a refuzat perechea utilizator + parolă la docker login. Folosește numele de utilizator Docker Hub (nu adresa de email) și, dacă ai autentificare în doi pași sau ești în firmă, un Personal Access Token în locul parolei, dat cu --password-stdin. WARNING! Using --password via the CLI is insecure. Use --password-stdin. E un avertisment, nu o eroare: login-ul poate reuși, dar parola dată cu -p rămâne în istoricul shell-ului și în jurnalele CI. Trimite-o prin intrarea standard: cat token.txt | docker login -u andrei --password-stdin (sau echo "$TOKEN" | ... în pipeline). Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running? Comanda docker (clientul) nu găsește serviciul Docker (daemon-ul dockerd) care face de fapt treaba. Pornește Docker Desktop sau serviciul cu sudo systemctl start docker, apoi verifică cu docker info. Î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.
