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

Error response from daemon: Get "https://registry.firma.ro/v2/": tls: failed to verify certificate: x509: certificate signed by unknown authority

Pe scurt

Daemon-ul nu are încredere în certificatul TLS al registry-ului, de obicei pentru că e semnat de autoritatea internă a firmei sau un proxy inspectează traficul. Pune certificatul CA al firmei în /etc/docker/certs.d/registry.firma.ro/ca.crt (sau în certificatele sistemului) și repornește Docker.

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

Ce înseamnă

Când vorbește cu un registry prin HTTPS, daemon-ul verifică cine a semnat certificatul serverului. Dacă autoritatea (CA) nu e în lista de încredere, conexiunea e oprită: x509: certificate signed by unknown authority.

În firme, cauza e aproape mereu una din două: registry-ul intern (registry.firma.ro, Harbor, Nexus, GitLab) are un certificat emis de CA-ul firmei, sau un proxy de securitate interceptează traficul spre internet și îl resemnează cu propriul certificat, deci și Docker Hub pare „semnat de necunoscut”.

Reparația corectă e să adaugi CA-ul firmei: pentru un singur registry, în /etc/docker/certs.d/<registry>/ca.crt (Docker îl citește la fiecare conexiune), sau în certificatele de încredere ale sistemului, urmat de repornirea daemon-ului. Varianta insecure-registries dezactivează verificarea și nu e o soluție pentru producție.

De ce apare: cauzele frecvente

1Registry intern cu CA-ul firmei

Greșit
BASH
docker pull registry.firma.ro/echipa/api:1.0
Corect
BASH
sudo mkdir -p /etc/docker/certs.d/registry.firma.ro
sudo cp firma-ca.crt /etc/docker/certs.d/registry.firma.ro/ca.crt
docker pull registry.firma.ro/echipa/api:1.0

Docker caută CA-uri suplimentare în folderul cu numele exact al registry-ului (inclusiv portul, dacă există).

2Proxy care inspectează HTTPS

Greșit
BASH
docker pull node:20-alpine
# x509 și pentru Docker Hub
Corect
BASH
sudo cp firma-ca.crt /usr/local/share/ca-certificates/firma-ca.crt
sudo update-ca-certificates
sudo systemctl restart docker

Proxy-ul semnează toate site-urile cu CA-ul firmei. Adăugat în sistem, e acceptat pentru orice registry.

3Certificat pus în imagine, nu pe gazdă

Greșit
BASH
COPY firma-ca.crt /usr/local/share/ca-certificates/
Corect
BASH
# certificatul trebuie pe calculatorul care rulează daemon-ul
sudo cp firma-ca.crt /etc/docker/certs.d/registry.firma.ro/ca.crt

Pull-ul îl face daemon-ul de pe gazdă. CA-ul din imagine ajută doar programele care rulează în container.

Repară tu

Repară eroarea, direct în pagină

La docker pull registry.firma.ro/echipa/api:1.0 primești x509: certificate signed by unknown authority. Echipa de infrastructură ți-a dat CA-ul firmei în ~/firma-ca.crt. Instalează-l pentru registry-ul registry.firma.ro, ca daemon-ul să aibă încredere în el (parola sudo este academia).

Indiciu

Daemon-ul caută CA-uri suplimentare în /etc/docker/certs.d/<numele registry-ului>/ca.crt.

Alte forme ale mesajului

  • x509: certificate signed by unknown authority
  • Error response from daemon: Get "https://registry-1.docker.io/v2/": tls: failed to verify certificate: x509: certificate signed by unknown authority
  • ERROR: failed to solve: failed to do request: Head "https://registry.firma.ro/v2/echipa/api/manifests/1.0": tls: failed to verify certificate: x509: certificate signed by unknown authority

Cum o eviți pe viitor

Cere de la echipa de infrastructură certificatul CA al firmei (fișier .crt în format PEM) și instalează-l o dată, la configurarea calculatorului. Pentru fiecare registry intern, folderul din /etc/docker/certs.d/ trebuie să aibă exact numele din imagine (registry.firma.ro:5000, dacă are port). Evită insecure-registries, care acceptă orice certificat.

Întrebări frecvente

Trebuie să repornesc Docker după ce pun ca.crt în certs.d?

Pentru /etc/docker/certs.d/ nu e obligatoriu, daemon-ul citește folderul la fiecare conexiune. Pentru certificatele sistemului (update-ca-certificates) da, repornește-l cu sudo systemctl restart docker.

Pe Docker Desktop unde pun certificatul?

Docker Desktop folosește certificatele de încredere ale sistemului (Keychain pe macOS, magazinul de certificate pe Windows). Instalează CA-ul acolo și repornește Docker Desktop.

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.