Stackrig

Startseite Blog

getestet auf einem frischen Ubuntu 24.04 ausgeführt, 6. Oktober 2026 Ausgeführt auf Ubuntu 24.04 veröffentlicht

Peer authentication failed for user "postgres" auf Ubuntu 24.04

Wir erhalten eine Provision, wenn du über die Links unten einkaufst. We earn commissions when you shop through the links below.

Wir haben „Peer authentication failed for user "postgres"“ auf einem frischen Ubuntu 24.04 ausgelöst, im Protokoll des Servers nachgelesen, warum, und uns mit einem Befehl angemeldet.

Kurze Antwort: Führ sudo -u postgres psql statt psql -U postgres aus. Am 6. Oktober 2026, auf einem frischen Ubuntu 24.04 mit PostgreSQL 16.15, scheiterte psql -U postgres unter unserem eigenen Benutzer mit Peer authentication failed for user "postgres", und sudo -u postgres psql meldete uns an. Auf dieser Installation wird der Datenbankbenutzer postgres über den Socket der Maschine nur hereingelassen, wenn der Systembenutzer mit demselben Namen fragt, und sudo -u postgres führt einen Befehl unter diesem Benutzer aus.

Worauf das lief und was diese Seite nicht behandelt

Wir haben jeden Befehl auf dieser Seite auf einer frischen virtuellen Maschine bei einem Cloud-Anbieter ausgeführt. Gestartet wurde sie aus Ubuntus offiziellem Server-Image für 24.04, und ein Skript hat dort die Befehle ausgeführt und alles festgehalten, was die Maschine ausgab. Ein Block mit der Aufschrift „Ausgabe“ zeigt, was der Befehl darüber ausgegeben hat, oder die Zeilen davon, auf die es ankommt, und eine Zeile steht ganz da oder ohne einen Anfang, auf den die Seite hinweist.

date -u +%Y-%m-%d
lsb_release -a
whoami
2026-10-06
Description:	Ubuntu 24.04.5 LTS
ubuntu

Das ist ein Ubuntu-Release, eine Maschine, ein Tag und eine Architektur, x86_64.

Wir haben PostgreSQL mit den beiden Befehlen unten aus Ubuntus Archiv installiert und danach nichts geändert. Das ist die letzte Zeile, die der erste ausgegeben hat.

sudo apt update
29 packages can be upgraded. Run 'apt list --upgradable' to see them.

Dann die Installation. An einem Terminal fragt apt, ob es weitermachen soll, und das Skript hat y eingetippt.

sudo apt install postgresql
Do you want to continue? [Y/n] y
psql --version
psql (PostgreSQL) 16.15 (Ubuntu 16.15-0ubuntu0.24.04.1)

Diese Seite behandelt eine Ursache des Fehlers: diese Installation, so wie sie ist, und eine Anmeldung als postgres von deinem eigenen Benutzer aus. Sie behandelt nicht denselben Fehler für einen eigenen Datenbankbenutzer, Passwörter, eine Änderung an der Konfiguration von PostgreSQL oder eine Verbindung aus einer Anwendung oder von einer anderen Maschine. Unsere Anleitung zur Installation von PostgreSQL auf Ubuntu 24.04 behandelt die ersten drei davon.

Insbesondere ändert diese Seite nichts an pg_hba.conf, der Datei, in der PostgreSQL festlegt, wer sich wie anmelden darf. Hier ist ihre Prüfsumme vor dem Fehler, zum Vergleich am Ende.

sudo sha256sum /etc/postgresql/16/main/pg_hba.conf
ad0df9635890926d79a12d5627b68af6b85b6254fa23cace2bbe077838969c9e  /etc/postgresql/16/main/pg_hba.conf

Der Fehler, absichtlich ausgelöst

Das ist der Befehl, der scheitert: eine Anmeldung als Datenbankbenutzer postgres, angegeben mit -U, ausgeführt als Systembenutzer ubuntu.

psql -U postgres
psql: error: connection to server on socket "/var/run/postgresql/.s.PGSQL.5432" failed: FATAL:  Peer authentication failed for user "postgres"

Warum PostgreSQL ablehnt

Die Meldung sagt nicht, was nicht zusammengepasst hat. Das Protokoll des Servers sagt es, in den drei Zeilen, die es über den Versuch geschrieben hat, hier gezeigt ohne das Datum, die Uhrzeit und die Prozessnummer am Anfang jeder Zeile.

sudo tail -n 3 /var/log/postgresql/postgresql-16-main.log
postgres@postgres LOG:  provided user name (postgres) and authenticated user name (ubuntu) do not match
postgres@postgres FATAL:  Peer authentication failed for user "postgres"
postgres@postgres DETAIL:  Connection matched file "/etc/postgresql/16/main/pg_hba.conf" line 118: "local   all             postgres                                peer"

Der angegebene Name („provided“) ist der Datenbankbenutzer, der mit -U verlangt wurde, derselbe Name, den der Fehler nach „for user“ wiederholt, und der authentifizierte Name („authenticated“) ist der Systembenutzer, unter dem der Befehl lief. Die letzte Zeile nennt die Regel, die der Server angewandt hat, Zeile 118 von pg_hba.conf. Für eine Verbindung über den Socket der Maschine als postgres steht in dieser Zeile peer. Das Handbuch von PostgreSQL beschreibt die Methode in einem Satz: Sie „works by obtaining the client's operating system user name from the kernel and using it as the allowed database user name“ (Peer Authentication). Der Kernel sagte ubuntu, der Befehl verlangte postgres, und das ist nicht derselbe Name. Das sind die Zeilen der Datei für Socket-Verbindungen, mit ihren Zeilennummern.

sudo grep -n "^local" /etc/postgresql/16/main/pg_hba.conf
118:local   all             postgres                                peer
123:local   all             all                                     peer
130:local   replication     all                                     peer

Die Lösung: als Systembenutzer postgres fragen

Die Maschine hat einen Systembenutzer namens postgres, und sudo -u führt einen Befehl unter einem anderen Benutzer aus (sudo(8)).

sudo -u postgres whoami
postgres

Führ psql so aus, ohne -U, und der Name, den der Kernel meldet, ist der Name des Datenbankbenutzers. An der Eingabeaufforderung von psql hat das Skript \conninfo eingetippt, das zeigt, wie du verbunden bist, und \q, das psql beendet.

sudo -u postgres psql
postgres=# \conninfo
You are connected to database "postgres" as user "postgres" via socket in "/var/run/postgresql" at port "5432".
postgres=# \q

Die beiden Dinge, die wir uns angesehen haben, sind unverändert: Die Prüfsumme von pg_hba.conf ist dieselbe wie vorher, und psql -U postgres scheitert wie zuvor.

sudo sha256sum /etc/postgresql/16/main/pg_hba.conf
ad0df9635890926d79a12d5627b68af6b85b6254fa23cace2bbe077838969c9e  /etc/postgresql/16/main/pg_hba.conf
psql -U postgres
psql: error: connection to server on socket "/var/run/postgresql/.s.PGSQL.5432" failed: FATAL:  Peer authentication failed for user "postgres"

Die Lösung ist also der andere Befehl, keine Reparatur des ersten.

Die App kannst du kostenlos im Browser ausprobieren, ohne Konto. Um zu erfahren, wann Pro fertig ist, trag dich in die Warteliste ein.

Quellen

  • Unser eigener Lauf: ein Skript auf einer frischen Maschine mit Ubuntu 24.04 am 6. Oktober 2026. Jeder Befehl und jede Ausgabe auf dieser Seite stammt aus dem Skript und seinem Protokoll.
  • Handbuch von PostgreSQL 16, 21.9 Peer Authentication: der oben zitierte Satz.
  • Handbuch von PostgreSQL 16, 21.1 The pg_hba.conf File: was die Datei ist, und dass ein local-Eintrag für Verbindungen über einen Unix-Domain-Socket gilt.
  • Die Manpage sudo(8) von Ubuntu 24.04 zu -u.
  • Stack-Overflow-Frage 18664074 (2013): wo nach dem Fehler gefragt wird. Sonst haben wir nichts daraus übernommen.

Stackrig