...
Eroare Docker · Imagini, tag-uri și registry

Error saving credentials: error storing credentials - err: exec: "docker-credential-desktop": executable file not found in $PATH, out: ``

Pe scurt

~/.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

Greșit
BASH
cat ~/.docker/config.json
{
  "credsStore": "desktop"
}
Corect
BASH
cat > ~/.docker/config.json <<'EOF'
{
  "auths": {}
}
EOF
docker login -u andrei

Fără credsStore, clientul salvează credențialele direct în config.json și nu mai caută helperul lipsă.

2Helperul există, dar nu e în PATH (macOS)

Greșit
BASH
echo $PATH
# lipsește /usr/local/bin
Corect
BASH
export PATH="/usr/local/bin:$PATH"
docker login

Docker Desktop pune docker-credential-desktop în /usr/local/bin. Clientul îl caută doar în PATH.

3WSL fără integrarea Docker Desktop

Greșit
BASH
# în Ubuntu din WSL
docker login
Corect
BASH
# 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ă tu

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.

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

← 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.