Réinitialisez un mot de passe d'administrateur Nextcloud perdu avec OCC

L'impossibilité d'accéder à l'interface web de Nextcloud n'empêche pas un administrateur serveur de modifier le mot de passe d'un compte local. Si vous pouvez accéder à l'interface de ligne de commande du serveur, exécutez la occ user:resetpasswordcommande intégrée de Nextcloud en tant qu'utilisateur du serveur web, puis connectez-vous avec le même nom d'utilisateur et le nouveau mot de passe. Cette commande fonctionne aussi bien pour les comptes administrateurs que pour les comptes utilisateurs ; « admin » n'est qu'un exemple de nom d'utilisateur.

Les commandes ci-dessous suivent le manuel d'administration de Nextcloud 35, vérifié le 10 octobre 2026. Remplacez le chemin d'installation d'exemple, l'utilisateur HTTP, l'exécutable PHP et le nom d'utilisateur par les valeurs utilisées par votre serveur.

Réinitialiser le mot de passe de manière interactive

1. Trouvez l'installation de Nextcloud et le compte serveur web.

Connectez-vous à l'hôte avec un compte disposant des droits d'accès à un shell et d'élévation de privilèges. Localisez le répertoire contenant le occscript. Sous Ubuntu ou Debian, le chemin courant est/var/www/nextcloud ; certaines installations packagées, conteneurisées ou hébergées utilisent un autre emplacement. La commande doit être exécutée dans le contexte d'installation de Nextcloud et en tant qu'utilisateur HTTP afin de garantir la cohérence des droits d'accès au fichier.

Sous Debian ou Ubuntu, cet utilisateur est généralement « utilisateur » www-data. Consultez la documentation Nextcloud apachepour Fedora ou CentOS, httpArch et wwwrunopenSUSE. Utilisez votre compte de serveur web habituel, et non nécessairement le compte Linux que vous utilisez pour vous connecter.

2. Exécutez la commande de réinitialisation du mot de passe OCC

Utilisez cette commande sur une installation Debian ou Ubuntu standard, en remplaçant le nom d'utilisateur par le nom correct s'il n'est pas déjà présentadmin :

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

Nextcloud vous invite à saisir un nouveau mot de passe. Ce mot de passe n'est pas inclus dans la commande shell, ce qui évite qu'il ne soit enregistré dans l'historique. Une fois la réinitialisation du mot de passe réussie, connectez-vous via l'interface web avec votre nom d'utilisateur et le nouveau mot de passe. N'utilisez pas de chevrons autour du nom d'utilisateur lors de sa modification.

La documentation officielle le précise également sudo -E -u www-data. Cette -Eoption préserve les variables d'environnement ; elle n'est pas nécessaire pour une réinitialisation interactive classique, sauf si votre installation requiert des paramètres d'environnement spécifiques. Exécutez la commande occavec la version de l'interface de ligne de commande PHP configurée pour votre serveur web. Si l' phpexécutable par défaut est incompatible, appelez explicitement le binaire PHP correspondant.

Si vous ne savez pas quel compte réinitialiser

Le nom d'utilisateur correspond au nom d'utilisateur Nextcloud du compte, et non nécessairement à son nom d'affichage ou à son adresse e-mail. Si vous possédez un autre compte administrateur, consultez la page Utilisateurs pour confirmer le nom d'utilisateur concerné. En ligne de commande, un administrateur peut lister les comptes avec :

sudo -u www-data php /var/www/nextcloud/occ user:list

Remplacez ` www-data<chemin_OCC>` et `<chemin_OCC>` selon vos besoins. Le résultat peut inclure de nombreux comptes d'utilisateurs ; évitez donc de le diffuser publiquement s'il contient des informations personnelles. Pour les installations de grande envergure, la commande prend en charge des options telles que les limites et les décalages ; consultez le occ help user:listrésultat actuel pour connaître la syntaxe disponible dans votre version.

Si vous avez encore accès à un autre administrateur Nextcloud, lui demander de réinitialiser votre mot de passe dans les paramètres Utilisateurs est une solution plus simple. Le lien de réinitialisation de la page de connexion est une autre option, uniquement si une adresse e-mail valide a été enregistrée sur votre page personnelle et si le serveur peut envoyer des e-mails. L'accès à OCC est utile lorsque ni l'une ni l'autre de ces solutions n'est possible, mais que vous disposez d'un accès shell.

Résoudre les problèmes courants de la ligne de commande

« Impossible d’ouvrir le fichier d’entrée » ou « fichier occ introuvable »

La commande pointe vers le mauvais répertoire d'installation. Modifiez le chemin d'accès au occscript. Vous pouvez également vous placer dans le répertoire d'installation et exécuter la version abrégée sudo -u www-data php occ user:resetpassword admin. N'exécutez pas un script portant un nom similaire depuis une autre instance de Nextcloud sur le même serveur.

Erreurs d'autorisation, de cache ou de PHP

Vérifiez que vous avez bien utilisé le compte HTTP et la version de l'interface de ligne de commande PHP (PHP CLI) requise par l'installation. La documentation OCC de Nextcloud indique qu'APCu est désactivé par défaut en mode ligne de commande PHP ; si OCC signale qu'APCu est indisponible, activez-le apc.enable_clien configurant correctement l'interface de ligne de commande ou suivez la --define apc.enable_cli=1procédure d'appel documentée. Ne modifiez pas les paramètres PHP web à l'aveuglette pour résoudre une erreur spécifique à l'interface de ligne de commande.

Le compte utilise un fournisseur d'identité externe

Certaines installations authentifient les comptes via LDAP, SAML ou un autre fournisseur d'identité externe. Dans ce cas, le fournisseur peut être l'autorité compétente pour le mot de passe, et une réinitialisation OCC appliquée aux données du compte local Nextcloud risque de ne pas modifier les identifiants utilisés lors de la connexion. Réinitialisez le mot de passe en suivant la procédure approuvée par le fournisseur d'identité, ou vérifiez que le système d'arrière-plan configuré prend en charge les modifications de mot de passe avant d'utiliser OCC. Cette commande concerne le mot de passe du compte Nextcloud et ne réinitialise pas les identifiants du fournisseur d'identité.

Vous exécutez Nextcloud dans un conteneur ou sur un hébergement géré.

Exécutez OCC dans le conteneur de l'application ou via l'interface de ligne de commande fournie par votre hébergeur, et non sur un hôte externe. Les noms de conteneurs, les chemins d'installation, les commandes PHP et les utilisateurs de service varient selon le déploiement ; par conséquent, ne copiez pas une commande Docker conçue pour une autre image sans consulter sa documentation. L'accès à l'interface de ligne de commande peut être restreint par l'hébergement géré ; si vous ne parvenez pas à exécuter OCC, utilisez le panneau de contrôle de votre hébergeur ou suivez la procédure de récupération documentée.

Vérifiez que vous avez retrouvé l'accès

Vérifiez que l'OCC a bien affiché un message de réussite, puis ouvrez l'URL Nextcloud habituelle dans une fenêtre de navigation privée et connectez-vous avec votre nom d'utilisateur et votre nouveau mot de passe. La navigation privée permet de distinguer un problème de mot de passe d'une ancienne session ou d'une page de connexion mise en cache. Une fois connecté, assurez-vous que le compte dispose toujours des droits d'administrateur et que vous pouvez accéder aux paramètres d'administration. Si la connexion échoue toujours, vérifiez à nouveau le nom d'utilisateur, le système d'authentification, les journaux du serveur et assurez-vous que l'OCC a été exécuté sur la bonne instance ; répéter la réinitialisation sur une instance incorrecte ne résoudra pas le problème sur le serveur actif.

Références officielles

Laisser un commentaire

Erreur de base de données Nextcloud après une mise à jour : que vérifier en premier ?

Rétablissez l'accès à Nextcloud après une mise à jour en diagnostiquant les erreurs SQL, en vérifiant la connectivité de la base de données et en terminant en toute sécurité les migrations interrompues.

Réinitialisez un mot de passe d'administrateur Nextcloud perdu avec OCC

Utilisez la commande OCC de Nextcloud pour réinitialiser un mot de passe administrateur depuis l'interface de ligne de commande du serveur, avec des instructions concernant les noms d'utilisateur, les permissions et les fournisseurs d'authentification externes.

Ajoutez l'en-tête HSTS au point de terminaison HTTPS qui héberge Nextcloud.

Éliminez l'avertissement HSTS de Nextcloud en configurant l'en-tête au niveau d'Apache, de NGINX ou de votre proxy TLS, puis vérifiez la réponse HTTPS publique en toute sécurité.

Résolution des problèmes d'installation de l'application Nextcloud signalant une absence de connexion Internet

Résolution des problèmes d'installation de l'application Nextcloud signalant une absence de connexion Internet

Identifiez les échecs d'installation de l'App Store comme étant liés à des problèmes de DNS, HTTPS, de proxy, TLS ou de configuration du serveur Nextcloud lui-même.

Maîtrisez les pics d'utilisation du processeur lors de la prévisualisation de Nextcloud grâce à une file d'attente planifiée

Déplacez le traitement des vignettes vers une planification en arrière-plan contrôlée, réduisez les tailles d'aperçu inutilisées et vérifiez la file d'attente sans surcharger votre serveur Nextcloud.

Obtenez Nextcloud Desktop Sync : passez à l’étape suivante, celle du « traitement des fichiers ».

Trouvez le fichier, la règle d'exclusion, le problème de connexion ou l'état de la base de données client qui bloque la synchronisation Nextcloud, puis vérifiez les chargements et les téléchargements en toute sécurité.

Éliminez l'avertissement OPcache de Nextcloud en ajustant la limite appropriée

Identifiez la limite du cache PHP OPcache qui déclenche l'avertissement de Nextcloud, mettez à jour la configuration PHP web correspondante, redémarrez en toute sécurité et vérifiez le résultat.

Connecter Nextcloud à CODE Docker : Configuration et compromis

Connecter Nextcloud à CODE Docker : Configuration et compromis

Comparez le code intégré et celui basé sur Docker, puis connectez Collabora Online à Nextcloud via un proxy inverse HTTPS sécurisé.

Créez un cluster Nextcloud résilient avec Galera

Planifiez un déploiement Nextcloud HA fiable avec stockage partagé, verrouillage Redis, routage MariaDB prenant en compte le quorum et contrôles de basculement pratiques.

Réussir les appels Nextcloud Talk même en cas de défaillance de Direct Media

Réussir les appels Nextcloud Talk même en cas de défaillance de Direct Media

Configurez et vérifiez un relais TURN accessible pour Nextcloud Talk lorsque des pare-feu ou un NAT restrictif bloquent les flux multimédias d'appel direct.