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

psql: error: connection to server on socket "/var/run/postgresql/.s.PGSQL.5432" failed: No such file or directory

Pe scurt

psql s-a conectat local, prin socket, într-un container în care nu rulează niciun server PostgreSQL. De obicei ai pornit un container nou (docker run postgres psql) în loc să intri în cel existent: folosește docker exec db psql -U postgres, sau dă -h cu numele containerului bazei.

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

Ce înseamnă

Fără -h, psql se conectează prin socket-ul Unix local /var/run/postgresql/.s.PGSQL.5432, adică la un server din același container. Mesajul No such file or directory, urmat de Is the server running locally and accepting connections on that socket?, spune că acel fișier nu există: în containerul în care rulează psql nu e pornit niciun server.

Cauzele frecvente în Docker:

  • docker run --rm postgres:16 psql -U postgres: pornește un container nou, în care rulează doar psql, nu serverul;
  • psql rulat în containerul aplicației, fără -h db;
  • containerul bazei încă pornește sau s-a oprit (verifică docker ps);
  • psql rulat direct pe calculator, unde nu există PostgreSQL local, deși baza e în container (folosește -h localhost -p 5432 cu portul publicat).

De ce apare: cauzele frecvente

1docker run în loc de docker exec

Greșit
BASH
docker run --rm postgres:16 psql -U postgres -c 'SELECT 1'
Corect
BASH
docker exec db psql -U postgres -c 'SELECT 1'

exec rulează psql în containerul unde merge deja serverul.

2Client în alt container, fără -h

Greșit
BASH
docker run --rm --network magazin-net postgres:16 psql -U postgres
Corect
BASH
docker run --rm --network magazin-net -e PGPASSWORD=parola postgres:16 psql -h db -U postgres

Cu -h db, psql se conectează prin rețea la containerul bazei, nu la un socket local.

3Serverul nu rulează

Greșit
BASH
docker exec db psql -U postgres   # db e Restarting
Corect
BASH
docker ps -a --filter name=db
docker logs db

Dacă serverul s-a oprit, logul arată de ce, de exemplu parola lipsă.

Repară tu

Repară eroarea, direct în pagină

Baza db (postgres:16) rulează, iar tu vrei să creezi în ea tabela comenzi. Comanda docker run --rm postgres:16 psql -U postgres -c 'CREATE TABLE comenzi (id int)' dă connection to server on socket ... failed: No such file or directory. Creează tabela în containerul care rulează deja și verifică cu \dt.

Indiciu

Ai nevoie de comanda care rulează psql în containerul db existent, nu într-unul nou.

Alte forme ale mesajului

  • psql: error: connection to server on socket "/var/run/postgresql/.s.PGSQL.5432" failed: No such file or directory Is the server running locally and accepting connections on that socket?
  • psql: could not connect to server: No such file or directory
  • connection to server at "localhost" (127.0.0.1), port 5432 failed: Connection refused

Cum o eviți pe viitor

Ține minte diferența: docker run creează un container nou, docker exec intră într-unul care rulează. Pentru clienți din alte containere, pune-i în aceeași rețea și conectează-te cu -h numele_containerului. În aplicații, folosește mereu o adresă explicită (DATABASE_URL cu host db), nu socket-ul local.

Întrebări frecvente

De ce mesajul vorbește de un socket, nu de un port?

Fără -h, psql preferă socket-ul Unix local, mai rapid decât TCP. Cu -h db sau -h localhost, folosește rețeaua și portul 5432, iar eroarea devine Connection refused dacă nu răspunde nimeni.

Pot rula psql de pe calculator?

Da, dacă ai psql instalat și portul e publicat (-p 5432:5432): psql -h localhost -U postgres. Altfel, folosește docker exec.

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.