Un Nextcloud admin password reset, autrement dit la réinitialisation du mot de passe administrateur, ne demande pas de réinstaller l'instance. La méthode la plus sûre consiste à essayer le lien de récupération, puis un autre compte administrateur, et à utiliser occ user:resetpassword seulement si ces voies sont indisponibles.
La commande agit sur un compte précis. Elle ne corrige pas automatiquement un second facteur perdu, un annuaire LDAP, un jeton d'application ou une clé de chiffrement liée à l'ancien secret. Ce guide aide à identifier le bon compte, exécuter occ selon le mode d'installation et contrôler l'accès obtenu. Pour replacer cette intervention dans l'administration de la plateforme, consultez le guide complet de Nextcloud.
Quelle méthode choisir avant d'utiliser occ ?
Nextcloud documente trois voies de récupération pour un administrateur qui ne peut plus se connecter :
- utiliser le lien de réinitialisation affiché après un échec de connexion, si une adresse e-mail exploitable est enregistrée dans le profil.
- demander à un autre administrateur de modifier le mot de passe depuis l'interface.
- lancer
occ user:resetpassworddepuis le serveur.
Respectez cet ordre. Le lien e-mail laisse une trace compréhensible pour l'utilisateur et ne demande aucun accès au système. Un autre administrateur peut vérifier le compte visé avant le changement. occ devient utile lorsqu'il n'existe plus de session d'administration fonctionnelle ou que l'envoi d'e-mail ne peut pas être utilisé.
Ne créez pas un second administrateur par réflexe
Un nouveau compte ne répare pas le compte initial et peut ajouter un accès oublié. Récupérez d'abord l'identifiant exact, le backend d'authentification et le mode de chiffrement. Créez un compte de secours seulement si votre procédure d'exploitation le prévoit, puis documentez son propriétaire et son usage.
Avant toute commande, vérifiez aussi l'URL de l'instance et l'environnement concerné. Une copie de recette, un ancien conteneur ou un volume non monté peut répondre correctement à occ sans modifier la production attendue.
Comment identifier le compte administrateur à réinitialiser ?
L'identifiant de connexion n'est pas forcément admin. Il peut différer du nom affiché, de l'adresse e-mail ou du nom de la personne. Depuis le répertoire Nextcloud, listez les comptes avec l'utilisateur HTTP :
sudo -E -u www-data php occ user:list
Pour une installation placée dans /var/www/nextcloud, utilisez le chemin complet si le répertoire courant est différent :
sudo -E -u www-data php /var/www/nextcloud/occ user:list
Affichez ensuite les informations du compte pressenti :
sudo -E -u www-data php /var/www/nextcloud/occ user:info alice
Contrôlez au minimum :
- l'identifiant exact, ici
alice; - l'état activé ou désactivé du compte ;
- son backend d'authentification ;
- son appartenance au groupe d'administration ;
- l'adresse e-mail de récupération attendue.
Ne choisissez pas un compte d'après son seul nom affiché. Sur une instance reliée à LDAP, OpenID Connect, SAML ou un autre fournisseur externe, le mot de passe peut être géré hors de Nextcloud. La réinitialisation doit alors être réalisée dans la source d'identité, sauf si le compte concerné est bien un compte local distinct.

Comment lancer user:resetpassword sur une installation classique ?
La commande officielle est interactive. Elle demande le nouveau mot de passe deux fois sans l'afficher dans le terminal :
sudo -E -u www-data php /var/www/nextcloud/occ user:resetpassword alice
Remplacez alice par l'identifiant vérifié à l'étape précédente. Exécutez occ avec l'utilisateur HTTP afin de conserver les droits cohérents sur les fichiers et répertoires de Nextcloud. Sur Debian et Ubuntu, cet utilisateur est généralement www-data. D'autres distributions et paquets utilisent un autre compte.
Une réponse de succès confirme que Nextcloud a accepté le changement pour ce compte. Elle ne valide pas encore la connexion complète. Ouvrez une fenêtre de navigation privée, saisissez l'identifiant exact et le nouveau mot de passe, puis contrôlez l'accès à l'administration. La fenêtre privée évite de confondre le test avec une ancienne session encore ouverte.
Si occ affiche une erreur PHP, une configuration manquante ou un message lié au cache, vérifiez d'abord que la commande utilise la même branche de PHP que l'instance. Le PHP du terminal peut charger un autre php.ini que PHP-FPM. Le guide sur la mémoire PHP et OPcache de Nextcloud explique comment distinguer ces contextes sans modifier toutes les valeurs à la fois.
Quelle commande utiliser avec Docker, AIO ou Snap ?
Le sous-commande Nextcloud reste user:resetpassword. Seul le moyen d'atteindre occ change.
Image Docker officielle avec Compose
Si le service applicatif s'appelle app, lancez :
docker compose exec --user www-data app \
php occ user:resetpassword alice
Adaptez le nom du service au fichier Compose réellement déployé. Vérifiez d'abord le projet et les conteneurs actifs avec docker compose ps. Une commande lancée depuis un autre dossier peut viser une autre pile.
Conteneur Docker identifié par son nom
Avec un conteneur nommé nextcloud, la forme équivalente est :
docker exec --user www-data -it nextcloud \
php occ user:resetpassword alice
L'option interactive permet de répondre aux deux demandes de mot de passe. N'ajoutez pas le secret directement à la ligne de commande. Il pourrait apparaître dans l'historique du shell ou dans des journaux d'automatisation.
Nextcloud All-in-One
AIO exécute Nextcloud dans le conteneur nextcloud-aio-nextcloud. Après avoir confirmé ce nom sur l'hôte, utilisez :
sudo docker exec --user www-data -it nextcloud-aio-nextcloud \
php occ user:resetpassword alice
N'exécutez pas la commande dans le conteneur maître ou le proxy Apache. Le code Nextcloud et son occ se trouvent dans le conteneur applicatif.
Paquet Snap
Le paquet Snap fournit son propre lanceur :
sudo nextcloud.occ user:resetpassword alice
Cette forme évite de deviner le chemin interne de occ et la version de PHP embarquée par le paquet.
Que faire si LDAP, la 2FA ou le chiffrement bloque encore l'accès ?
Le compte dépend d'un annuaire externe
Une commande Nextcloud ne remplace pas nécessairement le secret d'un compte LDAP ou d'un fournisseur d'identité. Relisez la sortie de user:info et la configuration du backend. Si l'identité est externe, appliquez la procédure de récupération de cette source, puis testez la synchronisation du compte dans Nextcloud.
Évitez de créer un compte local portant un identifiant proche pour contourner l'annuaire. Deux identités similaires peuvent recevoir des partages et des droits différents, ce qui rend la reprise plus difficile à auditer.
La connexion demande encore un second facteur
Le mot de passe et la double authentification sont deux contrôles séparés. Si le nouveau mot de passe est accepté mais que le second facteur est perdu, inspectez d'abord son état :
sudo -E -u www-data php /var/www/nextcloud/occ \
twofactorauth:state alice
Ne désactivez pas toute la 2FA de l'instance. Traitez le compte concerné selon la procédure de secours prévue, puis réenregistrez un facteur. Le guide de la double authentification Nextcloud détaille les codes de secours, les fournisseurs et la reprise d'un utilisateur.
Le chiffrement côté serveur utilise des clés par utilisateur
Le mode par clé maître, utilisé par défaut dans la documentation actuelle, protège la clé centrale avec le secret de l'instance. Une ancienne configuration ou un choix explicite peut toutefois utiliser une clé propre à l'utilisateur, elle-même liée à son mot de passe. Dans ce cas, un changement administratif réalisé sans l'ancien secret peut empêcher le déchiffrement des fichiers si aucune clé de récupération exploitable n'est configurée.
Avant de réinitialiser un compte sur une instance chiffrée, identifiez le mode actif, l'état de la clé de récupération et la présence d'une sauvegarde. Le guide du chiffrement côté serveur Nextcloud explique cette différence et les contrôles à effectuer. Ne lancez pas de commande de migration ou de déchiffrement pendant la récupération du compte : ce serait un second changement, avec un risque et un retour arrière différents.
Quels contrôles effectuer après la reprise ?
Une connexion réussie ne suffit pas à clore l'incident. Vérifiez le périmètre du compte et les accès encore actifs.
- Ouvrez l'administration depuis une fenêtre privée et confirmez que le compte possède toujours le rôle attendu.
- Testez une action sans effet destructif, par exemple l'ouverture de l'aperçu d'administration et la consultation de l'état système.
- Contrôlez la 2FA et réenregistrez un facteur si la procédure de récupération l'a modifiée.
- Examinez les jetons d'authentification associés au compte :
sudo -E -u www-data php /var/www/nextcloud/occ \
user:auth-tokens:list alice
- Révoquez les jetons inconnus ou inutiles avec leur identifiant, après avoir identifié l'appareil ou l'intégration concernée :
sudo -E -u www-data php /var/www/nextcloud/occ \
user:auth-tokens:delete alice 42
- Mettez à jour l'adresse de récupération si elle était absente ou obsolète.
- Consignez l'heure, le compte, la méthode et les contrôles, sans écrire le nouveau mot de passe dans le ticket ou le journal d'intervention.
Pour éviter une nouvelle perte d'accès, appliquez une politique de mot de passe Nextcloud adaptée aux comptes locaux et conservez au moins deux administrateurs nominatifs. Un compte de secours doit être surveillé, testé et protégé, pas seulement créé puis oublié.
Séparez récupération et durcissement
Rétablissez d'abord un accès vérifié. Traitez ensuite, dans un changement distinct, la rotation des jetons, la 2FA, les comptes de secours et les règles de mot de passe. Cette séparation facilite le diagnostic et le retour arrière.
Pourquoi la commande échoue-t-elle ?
« Could not open input file: occ »
Vous n'êtes pas dans le répertoire Nextcloud ou le chemin est incorrect. Localisez l'installation réellement servie par le serveur web, puis utilisez le chemin complet. Dans Docker, exécutez la commande dans le conteneur applicatif, pas sur l'hôte.
« User does not exist »
L'identifiant saisi n'est pas le nom affiché dans l'interface. Relancez user:list, vérifiez la casse et consultez user:info sur le compte retenu. N'essayez pas plusieurs identifiants au hasard sur une instance contenant des comptes homonymes.
L'erreur mentionne les permissions
La commande a peut-être été lancée avec le mauvais utilisateur système. Sur une installation classique, reprenez avec l'utilisateur HTTP. Ne corrigez pas toute l'arborescence avec un chown -R générique sans avoir identifié les propriétaires attendus des données, de la configuration et du code.
Le nouveau mot de passe est refusé
La politique de mot de passe peut imposer une longueur, des caractères, un historique ou un contrôle contre des secrets compromis. Lisez le message de occ et choisissez un nouveau secret conforme plutôt que de désactiver la règle pour tout le monde.
La page de connexion revient après validation
Le problème peut alors concerner le backend d'authentification, la 2FA, le proxy, les cookies ou l'URL utilisée. Testez l'URL canonique de l'instance dans une fenêtre privée et relevez l'heure exacte avant de consulter les journaux. Ne répétez pas la réinitialisation si la commande a déjà confirmé le changement.
Conclusion
Pour réinitialiser un mot de passe administrateur Nextcloud, commencez par le lien e-mail ou un second administrateur. Si occ est nécessaire, vérifiez l'identifiant et le backend, lancez user:resetpassword dans le bon environnement, puis testez la connexion dans une fenêtre privée.
Traitez séparément la 2FA, les jetons d'application et le chiffrement par clé utilisateur. La récupération est terminée lorsque le compte attendu se connecte, possède encore les bons droits et ne conserve que les accès reconnus.
Découvrir l'offre NextcloudInstance Nextcloud gérée avec assistance d'administrationSources officielles
- Nextcloud Administration Manual : réinitialiser un mot de passe administrateur perdu
- Nextcloud Administration Manual : utiliser la commande occ
- Nextcloud Administration Manual : commandes de gestion des utilisateurs
- Nextcloud Administration Manual : commandes de double authentification
- Nextcloud Administration Manual : authentification LDAP
- Nextcloud Administration Manual : détails du chiffrement côté serveur
- Image Docker officielle Nextcloud : exécuter occ dans le conteneur
- Paquet Snap officiel Nextcloud : lanceur nextcloud.occ