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_user

Voraussetzungen

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.

  1. Starte psql als Benutzer postgres:

sudo -u postgres psql

Ohne sudo geht es als root auch so:

su - postgres
psql
  1. Du siehst die Eingabeaufforderung postgres=#. Lass dir die vorhandenen Benutzer anzeigen:

\du

Schritt 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.

  1. Ändere das Passwort des gewünschten Benutzers:

\password app_user
  1. Gib das neue Passwort zweimal ein. Ohne Benutzernamen ändert \password das Passwort des Benutzers, mit dem du gerade angemeldet bist.

  2. Verlasse psql:

\q

Schritt 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:

  1. Suche die Datei pg_hba.conf:

ls /etc/postgresql/*/main/pg_hba.conf
  1. Lege 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
  1. Öffne die Datei:

nano /etc/postgresql/17/main/pg_hba.conf
  1. Suche die Zeile für lokale Verbindungen des Benutzers postgres und ändere nur die Methode am Zeilenende auf trust. Aus

local   all             postgres                                scram-sha-256

wird

local   all             postgres                                trust

PostgreSQL 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.

  1. Lade die Konfiguration neu (siehe auch Abschnitt „Dienst neu laden“):

pg_ctlcluster 17 main reload
  1. Melde dich an und setze das Passwort neu:

psql -U postgres
\password postgres
\q
  1. Stelle 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 reload
  1. Prü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 reload

Alternativ lädst du alle Cluster über den systemd-Dienst neu:

systemctl reload postgresql

Bist 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

Wenn es nicht klappt

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.