Tutorials

GitLab-Passwort über die Konsole zurücksetzen

Melden

Hier ist ein kompaktes Tutorial, wie du ein GitLab-Benutzerpasswort über die Kommandozeile (CLI) zurücksetzen kannst. Dies ist besonders hilfreich, wenn der Administrator-Zugang verloren ging oder der E-Mail-Versand nicht konfiguriert ist.

Um ein Passwort direkt auf dem Server zu ändern, nutzt du die GitLab-Rails-Konsole. Du benötigst dafür Root-Zugriff oder Sudo-Rechte auf dem Server, auf dem GitLab installiert ist.

Schritt 1: Die GitLab-Rails-Konsole öffnen

Melde dich per SSH auf deinem Server an und starte die interaktive Konsole mit folgendem Befehl:

sudo gitlab-rails console -e production

Hinweis: Es kann einen Moment dauern, bis die Konsole geladen ist.

Schritt 2: Den Benutzer finden

Du musst den Benutzer identifizieren, dessen Passwort du ändern möchtest. Das funktioniert am besten über den Benutzernamen oder die E-Mail-Adresse.

Suche per Benutzername:

user = User.find_by(username: 'dein_benutzername')

Oder Suche per E-Mail:

user = User.find_by(email: 'admin@example.com')

Schritt 3: Das Passwort ändern

Sobald der Benutzer in der Variable user gespeichert ist, kannst du das neue Passwort festlegen. Ersetze 'NeuesPasswort123' durch dein gewünschtes Passwort.

user.password = 'NeuesPasswort123'
user.password_confirmation = 'NeuesPasswort123'

Schritt 4: Änderungen speichern

Damit die Änderung wirksam wird, musst du das Benutzerobjekt speichern. Das Ausrufezeichen am Ende von save! sorgt dafür, dass bei Fehlern eine Fehlermeldung ausgegeben wird.

user.save!

Wenn die Antwort true lautet, wurde das Passwort erfolgreich geändert.

Schritt 5: Konsole verlassen

Du kannst die Rails-Konsole nun mit folgendem Befehl beenden:

exit

Wichtige Hinweise

  • Passwort-Komplexität: Das neue Passwort muss den in GitLab konfigurierten Komplexitätsregeln entsprechen (standardmäßig meist mindestens 8 Zeichen).
  • Keine E-Mail-Benachrichtigung: Wenn du das Passwort über die Konsole änderst, wird der Benutzer (je nach Version und Einstellung) nicht immer automatisch darüber informiert.
  • Gesperrte Accounts: Falls der Account wegen zu vieler Fehlversuche gesperrt war, kannst du ihn zusätzlich mit user.unlock_access! entsperren, bevor du user.save! ausführst.
0