...
Eroare Docker · Baze de date în containere

psql: error: connection to server on socket "/var/run/postgresql/.s.PGSQL.5432" failed: FATAL: role "root" does not exist

Pe scurt

psql s-a conectat cu numele utilizatorului din container (root, la docker exec), iar în PostgreSQL nu există rolul root. Spune-i explicit utilizatorul bazei: docker exec -it db psql -U postgres (sau utilizatorul din POSTGRES_USER).

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

Ce înseamnă

Fără -U, psql folosește ca utilizator al bazei de date numele utilizatorului de sistem care rulează comanda. În docker exec, comanda rulează implicit ca root, deci psql încearcă rolul root. Imaginea oficială postgres creează un singur superutilizator, postgres (sau cel din POSTGRES_USER), iar serverul răspunde că rolul root nu există.

Conexiunea în sine a reușit: serverul rulează și a primit cererea pe socket-ul local (/var/run/postgresql/.s.PGSQL.5432). Problema e doar numele utilizatorului.

Aceeași eroare apare cu alt nume când rulezi psql din alt container sau de pe calculator (role "ana" does not exist), sau când POSTGRES_USER=magazin a creat utilizatorul magazin, iar tu te conectezi cu -U postgres (role "postgres" does not exist).

De ce apare: cauzele frecvente

1psql fără -U în docker exec

Greșit
BASH
docker exec -it db psql
Corect
BASH
docker exec -it db psql -U postgres

-U postgres alege superutilizatorul creat de imagine.

2Utilizator setat cu POSTGRES_USER

Greșit
BASH
docker run -d --name db -e POSTGRES_USER=magazin -e POSTGRES_PASSWORD=p postgres:16
docker exec -it db psql -U postgres
Corect
BASH
docker exec -it db psql -U magazin

Cu POSTGRES_USER, superutilizatorul se numește magazin, iar postgres nu mai e creat.

3Baza implicită are numele utilizatorului

Greșit
BASH
docker exec -it db psql -U magazin -d postgres
Corect
BASH
docker exec -it db psql -U magazin -d magazin

Imaginea creează o bază cu numele lui POSTGRES_USER (dacă nu dai POSTGRES_DB).

Repară tu

Repară eroarea, direct în pagină

Containerul db rulează postgres:16, iar comanda docker exec db psql -c 'CREATE TABLE clienti (id int, nume text)' dă FATAL: role "root" does not exist. Creează tabela clienti conectându-te cu utilizatorul creat de imagine și verifică cu \dt.

Indiciu

psql are nevoie de -U postgres.

Alte forme ale mesajului

  • psql: error: connection to server on socket "/var/run/postgresql/.s.PGSQL.5432" failed: FATAL: role "postgres" does not exist
  • FATAL: role "root" does not exist
  • psql: FATAL: role "root" does not exist

Cum o eviți pe viitor

Scrie mereu -U la psql (și -d pentru baza dorită), mai ales în scripturi. Notează ce ai pus la POSTGRES_USER și POSTGRES_DB în compose.yaml; acelea sunt numele cu care te conectezi. Poți seta și variabilele PGUSER și PGDATABASE în container, ca psql să le folosească implicit.

Întrebări frecvente

De ce psql folosește root?

Convenția PostgreSQL: dacă nu dai -U, utilizatorul bazei are același nume ca utilizatorul de sistem. În container, docker exec rulează ca root.

Pot crea rolul root ca să scap de eroare?

Se poate (CREATE ROLE root SUPERUSER LOGIN), dar nu e o idee bună: e încă un superutilizator de administrat. Mai simplu e să folosești -U postgres.

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.