PostgreSQL: Passwort ändern oder zurücksetzen
PostgreSQL-Passwort mit ALTER USER oder \password ändern und ein vergessenes Passwort über den Benutzer postgres zurücksetzen, unter Debian und Ubuntu.
Stand: November 2026. Beschrieben für die PostgreSQL-Pakete aus Debian 12 (PostgreSQL 15) und Debian 13 (PostgreSQL 17), die Befehle gelten auch für neuere Versionen und für Ubuntu.
Diese Anleitung zeigt, wie du das Passwort eines PostgreSQL-Benutzers änderst und wie du wieder Zugriff bekommst, wenn das Passwort vergessen ist. In PostgreSQL heißen Benutzer „Rollen“, ALTER USER ist laut Dokumentation ein anderer Name für ALTER ROLE. Alle Befehle auf Systemebene führst du als root aus.
Kurz gesagt: Als root den Benutzer postgres verwenden, psql starten und das Passwort mit \password neu setzen. app_user ersetzt du durch den Namen des Benutzers, dessen Passwort du ändern willst:
sudo -u postgres psql\password app_userVoraussetzungen
Zugriff als root auf den Server, auf dem PostgreSQL läuft (direkt oder per SSH).
Ein installierter PostgreSQL-Server aus den Debian- oder Ubuntu-Paketen. Die Konfiguration liegt dort unter
/etc/postgresql/<Version>/main/, zum Beispiel/etc/postgresql/17/main/.Den Namen des Benutzers, dessen Passwort du ändern möchtest.
Schritt 1: Als Benutzer postgres anmelden
Debian richtet PostgreSQL so ein, dass sich der Linux-Benutzer postgres über die lokale Verbindung ohne Passwort als Datenbankbenutzer postgres anmelden darf. Diese Methode heißt peer: PostgreSQL übernimmt den Benutzernamen vom Betriebssystem. Sie gilt nur für lokale Verbindungen.
Starte psql als Benutzer postgres:
sudo -u postgres psqlOhne sudo geht es als root auch so:
su - postgres
psqlDu siehst die Eingabeaufforderung
postgres=#. Lass dir die vorhandenen Benutzer anzeigen:
\duSchritt 2: Passwort mit \password ändern (empfohlen)
Der psql-Befehl \password fragt das neue Passwort zweimal ab, verschlüsselt es und schickt es als ALTER ROLE an den Server. Laut PostgreSQL-Dokumentation erscheint das Passwort dadurch nicht im Klartext in der Befehlshistorie oder im Serverprotokoll.
Ändere das Passwort des gewünschten Benutzers:
\password app_userGib das neue Passwort zweimal ein. Ohne Benutzernamen ändert
\passworddas Passwort des Benutzers, mit dem du gerade angemeldet bist.Verlasse psql:
\qSchritt 3: Passwort mit ALTER USER ändern
Für Skripte oder wenn du psql nicht interaktiv nutzen kannst, setzt du das Passwort per SQL:
ALTER USER app_user WITH PASSWORD 'NeuesSicheresPasswort';Gleichwertig ist:
ALTER ROLE app_user WITH PASSWORD 'NeuesSicheresPasswort';Beachte dabei: Das Passwort wird im Klartext an den Server übertragen und kann laut Dokumentation in der Befehlshistorie des Clients oder im Serverprotokoll landen. Nutze deshalb wenn möglich \password aus Schritt 2.
Ein Passwort entfernst du mit:
ALTER USER app_user WITH PASSWORD NULL;Danach kann sich der Benutzer nicht mehr per Passwort anmelden.
Vergessenes Passwort zurücksetzen
Fall 1: Die Anmeldung aus Schritt 1 funktioniert. Dann brauchst du kein altes Passwort. Melde dich wie in Schritt 1 an und setze das Passwort wie in Schritt 2 neu. Das gilt auch für den Benutzer postgres selbst (\password postgres). Das ist der Normalfall bei Debian und Ubuntu.
Fall 2: Auch sudo -u postgres psql fragt nach einem Passwort. Dann wurde die lokale Anmeldung in der Datei pg_hba.conf auf eine Passwortmethode umgestellt. In diesem Fall erlaubst du die lokale Anmeldung kurzzeitig ohne Passwort:
Suche die Datei
pg_hba.conf:
ls /etc/postgresql/*/main/pg_hba.confLege eine Sicherungskopie an (im Beispiel Version 17, passe die Nummer an):
cp -a /etc/postgresql/17/main/pg_hba.conf /etc/postgresql/17/main/pg_hba.conf.bakÖffne die Datei:
nano /etc/postgresql/17/main/pg_hba.confSuche die Zeile für lokale Verbindungen des Benutzers postgres und ändere nur die Methode am Zeilenende auf
trust. Aus
local all postgres scram-sha-256wird
local all postgres trustPostgreSQL prüft die Zeilen von oben nach unten und verwendet die erste passende. Ändere deshalb die erste local-Zeile, die für postgres gilt. Ändere keine Zeilen, die mit host beginnen: trust lässt jede Verbindung ohne Prüfung zu und darf nie für Netzwerkverbindungen gelten.
Lade die Konfiguration neu (siehe auch Abschnitt „Dienst neu laden“):
pg_ctlcluster 17 main reloadMelde dich an und setze das Passwort neu:
psql -U postgres\password postgres
\qStelle die ursprüngliche Datei sofort wieder her und lade die Konfiguration erneut. Damit gilt wieder die vorherige Methode, bei aktuellen Installationen in der Regel
scram-sha-256:
cp -a /etc/postgresql/17/main/pg_hba.conf.bak /etc/postgresql/17/main/pg_hba.conf
pg_ctlcluster 17 main reloadPrüfe die Anmeldung mit dem neuen Passwort über eine Netzwerkverbindung:
psql -h 127.0.0.1 -U postgres -c "SELECT current_user;"Dienst neu laden
Änderungen an der pg_hba.conf liest PostgreSQL beim Start und beim Neuladen der Konfiguration. Ein Neustart ist nicht nötig, laufende Verbindungen bleiben beim Neuladen bestehen. Unter Debian und Ubuntu lädst du einen Cluster mit pg_ctlcluster neu (Version und Clustername anpassen). Als root leitet pg_ctlcluster den Befehl an systemd weiter:
pg_ctlcluster 17 main reloadAlternativ lädst du alle Cluster über den systemd-Dienst neu:
systemctl reload postgresqlBist du bereits in psql angemeldet, geht es auch per SQL:
SELECT pg_reload_conf();Ob die Datei fehlerfrei gelesen wurde, zeigt die Sicht pg_hba_file_rules. Zeilen mit einem Eintrag in der Spalte error enthalten Fehler:
SELECT line_number, type, database, user_name, auth_method, error FROM pg_hba_file_rules;Sicherheitshinweis
trustnur kurz und nur lokal: Solangetrustaktiv ist, kann sich jeder Benutzer mit Zugang zum Server ohne Passwort als postgres anmelden. Stelle die Datei direkt nach dem Zurücksetzen wieder her.Verschlüsselungsverfahren: Standard ist
scram-sha-256. MD5-Passwörter sind laut PostgreSQL-Dokumentation veraltet und werden in einer künftigen Version entfernt. Hast du Benutzer noch mit MD5 angelegt, setze deren Passwort einfach neu: Neue Passwörter werden mit dem aktuellen Verfahren gespeichert.Klartext vermeiden: Nutze
\passwordstattALTER USER ... PASSWORD, damit das Passwort nicht in der Befehlshistorie oder im Serverprotokoll steht.Anwendungen anpassen: Nach der Änderung müssen alle Programme, die sich mit diesem Benutzer verbinden, das neue Passwort erhalten, zum Beispiel in einer Konfigurationsdatei oder einer
.pgpass.
Wenn es nicht klappt
Peer authentication failed for user: Du verbindest dich lokal mit einem Datenbankbenutzer, der nicht wie dein Linux-Benutzer heißt. Verbinde dich über das Netzwerk mit Passwort (psql -h 127.0.0.1 -U app_user) oder melde dich wie in Schritt 1 als postgres an.password authentication failed for user: Das Passwort ist falsch oder der Benutzer hat keines. Setze es wie oben beschrieben neu.Die Änderung an der
pg_hba.confwirkt nicht: Die Konfiguration wurde nicht neu geladen, oder eine weiter oben stehende Zeile passt zuerst. Prüfe die Reihenfolge und die Sichtpg_hba_file_rules.Befehle wie
pg_ctlclusterwerden nicht gefunden: Du bist mitsustattsu -root geworden, siehe Linux: Befehle wie reboot werden nicht gefunden (PATH-Problem).
Häufige Fragen
Wie lautet das Standardpasswort des Benutzers postgres?
Unter Debian und Ubuntu hat der Benutzer postgres nach der Installation normalerweise kein Passwort. Die lokale Anmeldung erfolgt über die Methode peer, also mit sudo -u postgres psql. Ein Passwort brauchst du nur für Verbindungen über das Netzwerk, du setzt es mit \password postgres.
Was ist der Unterschied zwischen ALTER USER und ALTER ROLE?
Keiner. ALTER USER ist laut PostgreSQL-Dokumentation ein anderer Name für ALTER ROLE. Beide Befehle ändern das Passwort auf dieselbe Weise.
Wo liegt die Datei pg_hba.conf?
Bei den Debian- und Ubuntu-Paketen unter /etc/postgresql/<Version>/main/pg_hba.conf. Ist eine Anmeldung möglich, zeigt SHOW hba_file; in psql den genauen Pfad.
Muss ich PostgreSQL nach der Passwortänderung neu starten?
Nein. Ein neues Passwort gilt sofort für neue Verbindungen. Nur nach Änderungen an der pg_hba.conf lädst du die Konfiguration neu, ein vollständiger Neustart ist auch dafür nicht nötig.
Wie setze ich das root-Passwort von MySQL oder MariaDB zurück?
Das funktioniert anders als bei PostgreSQL. Eine Anleitung findest du im Artikel MySQL/MariaDB: root-Passwort zurücksetzen.
Verwandte Artikel
Unterstützung durch Dawico
Du kommst an einer Stelle nicht weiter oder möchtest Aufgaben wie diese abgeben? Die Dawico Deutschland GmbH ist seit 2008 IT-Dienstleister. Sprich uns an: telefonisch unter 030 8878680 oder über unsere Kontaktseite. Mehr zur laufenden IT-Betreuung durch Dawico.
Du bist bereits Kunde? Dann erreichst du uns über das Ticket-System oder per Fernwartung und Support.