So setzen Sie ein Nextcloud-Administratorpasswort mit OCC zurück

Wenn Sie sich nicht mehr mit einem Administratorkonto bei Nextcloud anmelden können, occlässt sich das Passwort dieses Kontos serverseitig zurücksetzen, ohne die Weboberfläche zu verwenden. occist die Kommandozeilenschnittstelle von Nextcloud für die Administration. Durch das Zurücksetzen wird das Passwort des Nextcloud-Kontos geändert; Ihr Linux-Login, Ihr Datenbankpasswort oder Ihr Passwort für das Hosting-Kontrollpanel bleiben davon unberührt.

Diese Anleitung basiert auf dem aktuellen Nextcloud-Administrationshandbuch (Version 35) vom 6. Oktober 2026. Der grundlegende Befehl ist über viele Versionen hinweg stabil, Installationspfade, PHP-Befehle, Dienstkonten und Container-Workflows können jedoch variieren. Verwenden Sie die Beispielwerte erst, nachdem Sie die Installation Ihrer eigenen Instanz überprüft haben.

Was Sie vor dem Zurücksetzen benötigen

• Shell-Zugriff auf den Server oder den Container, auf dem die PHP-Anwendung von Nextcloud ausgeführt wird.
• Der Dateisystempfad zur Nextcloud-Installation, also das Verzeichnis, das die occDatei enthält.
• Die genaue Nextcloud-Konto-ID, deren Passwort geändert werden muss. Die Konto-ID darf nicht … sein admin.
• Das Betriebssystemkonto, das vom Webserver oder der PHP-Laufzeitumgebung verwendet wird. Unter Debian und Ubuntu ist dies häufig www-data; andere Systeme verwenden möglicherweise ein anderes Konto.
• Ein neues, einzigartiges Passwort, das in einem Passwort-Manager gespeichert ist.

Führen Sie occdie Anwendung als HTTP-Benutzer aus – also als das Betriebssystemkonto, unter dem die Webanwendung läuft –, damit Dateibesitz und Berechtigungen konsistent bleiben. Diese Anforderung ist im Nextcloud-Handbuch dokumentiert. Führen Sie Befehle nicht standardmäßig als Root aus, nur weil Sie über sudo-Rechte verfügen.

Schritt 1: Die richtige Installation und das richtige Konto finden

Stellen Sie eine SSH-Verbindung her oder öffnen Sie die Shell Ihrer Hosting-Umgebung. Wechseln Sie in das Nextcloud-Installationsverzeichnis. Ein gängiger Installationspfad ist `/usr/local/nextcloud` /var/www/nextcloud, Pakete, Appliances, Container und gehostete Dienste können jedoch andere Pfade verwenden.

cd /var/www/nextcloud
ls -l occ

Der zweite Befehl sollte eine occDatei anzeigen. Falls dies nicht der Fall ist, brechen Sie ab und suchen Sie das tatsächliche Anwendungsverzeichnis, anstatt Pfade zu erraten. Wenn Sie einen anderen Kontonamen verwenden, ersetzen Sie adminim späteren Befehl „“ durch Ihre exakte Nextcloud-Benutzer-ID. Die Benutzer-ID ist nicht unbedingt der Anzeigename oder die E-Mail-Adresse.

Schritt 2: Führen Sie die interaktive Passwortzurücksetzung durch.

Bei einer typischen Debian- oder Ubuntu-Quellcodeinstallation, deren Webserver als ausgeführt wird www-data, führen Sie folgenden Befehl im Nextcloud-Verzeichnis aus:

sudo -E -u www-data php occ user:resetpassword admin

Ersetzen Sie die Platzhalter, www-datafalls Ihr Server einen anderen HTTP-Benutzer verwendet, und ersetzen Sie die Platzhalter admindurch die von Ihnen bestätigte Konto-ID. Falls Sie sich noch nicht im Installationsverzeichnis befinden, verwenden Sie den vollständigen Pfad:

sudo -E -u www-data php /var/www/nextcloud/occ user:resetpassword admin

Nextcloud fordert Sie zur Eingabe des neuen Passworts auf und bittet Sie, dieses zu bestätigen. Die Passwortzeichen werden während der Eingabe normalerweise nicht angezeigt; dies ist das erwartete Verhalten. Geben Sie bei beiden Aufforderungen dasselbe Passwort ein. Eine Erfolgsmeldung bestätigt, dass Nextcloud die Zurücksetzung akzeptiert hat.

Schritt 3: Verwenden Sie eine Umgebungsvariable nur für die Automatisierung.

Nextcloud unterstützt auch --password-from-envskriptgesteuerte Vorgänge. Das Passwort wird aus der OC_PASSUmgebungsvariablen gelesen. Vermeiden Sie es, ein echtes Passwort direkt in der Befehlszeile, im Shell-Verlauf, in einem in die Versionsverwaltung eingecheckten Skript oder in einem freigegebenen Terminalprotokoll anzugeben.

Für eine einmalige Shell-Sitzung können Sie das Geheimnis eingeben, ohne es auszugeben, es exportieren, den dokumentierten Befehl ausführen und es dann löschen:

read -s OC_PASS
export OC_PASS
sudo -E -u www-data php occ user:resetpassword --password-from-env admin
unset OC_PASS

Geben Sie anschließend read -sdas neue Passwort ein und drücken Sie die Eingabetaste; die Eingabe bleibt verborgen. Die -EOption weist sudo an, die Umgebungsvariablen beizubehalten, jedoch können lokale sudo-Richtlinien dieses Verhalten einschränken. Falls der Befehl meldet, dass die Umgebungsvariablen OC_PASSfehlen oder leer sind, verwenden Sie stattdessen die interaktive Zurücksetzung oder befolgen Sie die Verfahren zur Geheimnisverwaltung Ihrer Plattform. Deaktivieren Sie die sudo-Sicherheitsvorkehrungen nicht, nur um ein Skript zum Laufen zu bringen.

Schritt 4: Überprüfen Sie, ob sich das Konto anmelden kann

Öffnen Sie Ihre gewohnte Nextcloud-URL in einem privaten Browserfenster oder melden Sie sich von der aktuellen Sitzung ab und melden Sie sich anschließend mit derselben Benutzerkennung und dem neuen Passwort wieder an. Eine erfolgreiche Anmeldung bestätigt, dass die Anmeldeinformationen in der Webanwendung funktionieren und nicht nur, dass der Befehl in der Befehlszeile ausgeführt wurde. Falls Ihre Organisation eine Zwei-Faktor-Authentifizierung verwendet, führen Sie auch diese durch.

Häufige Probleme und wie man darauf reagiert

• Could not open input file: occoder es tritt ein Fehler aufgrund einer fehlenden Datei auf: Sie befinden sich wahrscheinlich im falschen Verzeichnis oder verwenden den falschen Pfad. Suchen Sie die installierte occDatei und führen Sie den Befehl dort erneut aus.
• Berechtigungs- oder Eigentumsfehler: Überprüfen Sie das Webserver-/PHP-Konto Ihrer Distribution und führen Sie den Befehl mit diesem Konto aus. Ändern Sie die Eigentumsrechte nicht rekursiv als schnelle Lösung; dies kann zu weitergehenden Zugriffsproblemen führen.
• „Benutzer existiert nicht“ oder eine ähnliche Fehlermeldung: Bitte überprüfen Sie die Konto-ID (Groß-/Kleinschreibung beachten). Verwenden Sie keine E-Mail-Adresse, es sei denn, es handelt sich tatsächlich um die Konto-ID.
• phpWenn eine PHP-Version fehlt oder die falsche ausgewählt ist: Verwenden Sie die von Ihrer Nextcloud-Installation und Hosting-Plattform unterstützte PHP-CLI-Binärdatei. Auf einem Server können mehrere PHP-Installationen vorhanden sein. Gehen Sie daher nicht davon aus, dass der Standardbefehl mit der Web-Laufzeitumgebung übereinstimmt.
• Der Server läuft in Docker, Nextcloud AIO, Snap oder als Appliance: Führen Sie ihn occin der Anwendungsumgebung aus und befolgen Sie die offizielle Befehlsprozedur dieser Bereitstellung. Hostpfad, Containername und Laufzeitbenutzer unterscheiden sich; ein aus einer Quellinstallation kopierter Host-Befehl kann das falsche Dateisystem ansprechen.
• Das Konto wird über LDAP oder Active Directory verwaltet: Diese Systeme können als Instanz für die Kontoanmeldeinformationen dienen. Eine lokale Nextcloud-Passwortzurücksetzung aktualisiert möglicherweise kein extern verwaltetes Passwort. Befolgen Sie die Anweisungen des Verzeichnisadministrators zur Passwortzurücksetzung und überprüfen Sie die Konfiguration Ihres Identitätsanbieters.
• Sie haben keinen Shell-Zugriff: Versuchen Sie den Link zum Zurücksetzen des Passworts auf der Anmeldeseite, falls für das Konto eine funktionierende E-Mail-Adresse in Nextcloud hinterlegt ist, oder bitten Sie einen anderen Nextcloud-Administrator oder Ihren Hosting-Anbieter, das Passwort zurückzusetzen.

Was man nach der Genesung vermeiden sollte

Bearbeiten Sie die Nextcloud-Datenbank nicht direkt, um einen Passwort-Hash zu ersetzen. Ändern Sie nicht das Betriebssystempasswort in der Annahme, dadurch einen Nextcloud-Benutzer zurückzusetzen. Halten Sie das neue Passwort geheim, entfernen Sie alle temporären Passwörter aus der Shell-Umgebung und speichern Sie es in Ihrem Passwort-Manager. Falls Sie vermuten, dass die alten Zugangsdaten kompromittiert wurden, überprüfen Sie die Zugriffsrechte gemäß den üblichen Sicherheitsrichtlinien Ihres Unternehmens.

Offizielle Referenzen

Nextcloud dokumentiert die Wiederherstellungsoptionen und das Vorgehen bei Verlust des Administratorpassworts unter „ Zurücksetzen eines verlorenen Administratorpassworts“ . Die unterstützten Befehle, Passwortabfragen und Umgebungsvariablenoptionen werden in „ Benutzer- und Gruppenbefehle“ und „Verwendung des Befehls occ“ beschrieben .