Skip to main content

Schritte zum Zurücksetzen des Portainer-Administratorpassworts

Voraussetzungen​

  1. Öffnen Sie das SSH-Terminal Ihres TNAS.
  2. Stellen Sie sicher, dass Portainer im TNAS App Center gestoppt wurde (muss gestoppt sein, da die Datenbankdatei sonst belegt ist und das Zurücksetzen fehlschlägt).

Schritte​

1. Finden Sie Ihr Portainer-Datenverzeichnis​

Suchen Sie zunächst den Portainer-Datenordner, der die Datei portainer.db enthält.

Führen Sie den folgenden Befehl aus:

find /Volume1/@apps/Portainer -name "portainer.db"

Nach der Ausführung sehen Sie eine ähnliche Ausgabe wie:

/Volume1/@apps/Portainer/portainer.db

Notieren Sie sich den Pfad /Volume1/@apps/Portainer – dies ist Ihr Datenverzeichnis.

2. Führen Sie den offiziellen Reset-Befehl aus​

Ersetzen Sie /path/to/portainer im folgenden Befehl durch den Datenverzeichnispfad, den Sie im vorherigen Schritt gefunden haben, und kopieren Sie ihn dann in das Terminal:

docker run --rm -v /path/to/portainer:/data portainer/helper-reset-password

Beispiel:

Wenn Ihr Datenverzeichnis /Volume1/@apps/Portainer ist, lautet der vollständige Befehl:

docker run --rm -v /Volume1/@apps/Portainer:/data portainer/helper-reset-password

3. Neues Passwort abrufen​

Nach der Ausführung des Befehls gibt das Terminal eine ähnliche Ausgabe aus wie:

2025/04/22 12:00:00 Password successfully updated for user: admin
2025/04/22 12:00:00 Use the following password to login:  aBcD1234!@#$
  • Die erste Zeile zeigt an, dass das Zurücksetzen erfolgreich war.
  • Das aBcD1234!@#$ in der zweiten Zeile ist das temporäre neue Passwort – kopieren Sie es!

4. Starten Sie Portainer und melden Sie sich an​

  1. Gehen Sie zurück zum TNAS App Center und starten Sie Portainer neu.
  2. Öffnen Sie die Portainer-Webseite (Standardadresse: http://Ihre_TNAS_IP:9000).
  3. Geben Sie als Benutzernamen admin ein und fügen Sie das zuvor kopierte temporäre Passwort ein, dann können Sie sich anmelden.

5. (Dringend empfohlen) Ändern Sie das Passwort sofort nach der Anmeldung​

  1. Klicken Sie nach der Anmeldung bei Portainer oben rechts auf Ihren Benutzeravatar.
  2. Wählen Sie My Account → Change Password.
  3. Geben Sie das temporäre Passwort ein, legen Sie Ihr eigenes neues Passwort fest und speichern Sie es.

Häufig gestellte Fragen​

1. Warum muss Portainer zuerst gestoppt werden?​

Weil Portainer die Datei portainer.db während des Betriebs sperrt; das Reset-Tool kann sie dann nicht ändern. Nach dem Stoppen wird die Datei freigegeben und das Zurücksetzen kann gelingen.

2. Bleiben meine zuvor erstellten Benutzer und Konfigurationen nach dem Zurücksetzen erhalten?​

Dieser Vorgang setzt nur das Admin-Passwort zurück. Andere Benutzer, die Laufzeitumgebung, Vorlagendateien und alle Systemkonfigurationsparameter werden nicht gelöscht oder geändert.

3. Der Befehl gibt docker: command not found zurück?​

Das bedeutet, dass die Docker-Engine auf Ihrem TNAS nicht aktiviert ist. Gehen Sie zum TNAS App Center, installieren und aktivieren Sie Docker Engine, und führen Sie den Befehl dann erneut aus.

4. Nach der Ausführung des Befehls wird kein Passwort ausgegeben?​

  • Überprüfen Sie, ob der Pfad zum Datenverzeichnis korrekt ist.
  • Stellen Sie sicher, dass Portainer vollständig gestoppt wurde.
  • Führen Sie den Befehl erneut aus.