Comment réinitialiser un mot de passe d'administrateur Nextcloud avec OCC

Si vous ne parvenez plus à vous connecter à Nextcloud avec un compte administrateur, la occcommande côté serveur permet de réinitialiser le mot de passe de ce compte sans utiliser l'interface web. occest l'interface en ligne de commande de Nextcloud pour l'administration. La réinitialisation modifie le mot de passe du compte Nextcloud ; elle ne modifie pas votre identifiant Linux, le mot de passe de votre base de données ni celui de votre panneau de contrôle d'hébergement.

Ce guide utilise le manuel d'administration de Nextcloud 35 en vigueur au 6 octobre 2026. La commande de base reste stable d'une version à l'autre, mais les chemins d'installation, les commandes PHP, les comptes de service et les flux de travail des conteneurs varient. N'utilisez les valeurs d'exemple qu'après avoir vérifié la configuration de votre instance.

Ce dont vous avez besoin avant de procéder à la réinitialisation

• Accès shell au serveur ou au conteneur qui exécute l'application PHP de Nextcloud.
• Le chemin d'accès au système de fichiers de l'installation de Nextcloud, c'est-à-dire le répertoire contenant le occfichier.
• L'identifiant exact du compte Nextcloud dont le mot de passe doit être modifié. Cet identifiant ne doit pas être un point admin.
• Le compte système utilisé par le serveur web ou l'environnement d'exécution PHP. Sous Debian et Ubuntu, il s'agit souvent de `/etc/php`www-data ; d'autres systèmes peuvent utiliser un autre compte.
• Un nouveau mot de passe unique, stocké dans un gestionnaire de mots de passe.

Exécutez les commandes occen tant qu'utilisateur HTTP (le compte système qui exécute l'application web) afin de garantir la cohérence des droits d'accès et de propriété des fichiers. Cette exigence est documentée dans le manuel de Nextcloud. N'exécutez pas de commandes en tant que superutilisateur (root) par défaut, même si vous disposez des droits sudo.

Étape 1 : Trouvez l’installation et le compte appropriés

Connectez-vous via SSH ou ouvrez l'invite de commandes fournie par votre environnement d'hébergement. Accédez au répertoire d'installation de Nextcloud. Le chemin d'installation source le plus courant est `/ /var/www/nextcloudusr/local ...

cd /var/www/nextcloud
ls -l occ

La deuxième commande devrait afficher un occfichier. Si ce n'est pas le cas, arrêtez-vous et localisez le répertoire d'application plutôt que d'essayer des chemins approximatifs. Si vous utilisez un nom de compte différent, remplacez ` admin<nom_utilisateur>` dans la commande suivante par votre identifiant Nextcloud exact. Cet identifiant ne correspond pas nécessairement à votre nom d'affichage ni à votre adresse e-mail.

Étape 2 : Exécutez la réinitialisation interactive du mot de passe

Pour une installation source Debian ou Ubuntu classique dont le serveur web s'exécute sous www-data, exécutez ceci depuis le répertoire Nextcloud :

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

Remplacez `<user>` par l'identifiant du compte que vous avez confirmé www-datasi votre serveur utilise un autre utilisateur HTTP admin. Si vous n'êtes pas déjà dans le répertoire d'installation, utilisez le chemin complet :

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

Nextcloud vous invite à saisir votre nouveau mot de passe et vous demande de le confirmer. Les caractères du mot de passe ne s'affichent généralement pas pendant la saisie ; c'est le comportement normal. Saisissez le même mot de passe aux deux invites. Un message de confirmation indique que Nextcloud a bien pris en compte la réinitialisation.

Étape 3 : Utiliser une variable d’environnement uniquement à des fins d’automatisation

Nextcloud prend également en charge --password-from-envles opérations scriptées. Il lit le mot de passe depuis une OC_PASSvariable d'environnement. Évitez de saisir un mot de passe réel directement dans une ligne de commande, l'historique du shell, un script versionné ou une transcription de terminal partagé.

Pour une session shell ponctuelle, vous pouvez saisir le secret sans l'afficher, l'exporter, exécuter la commande documentée, puis l'effacer :

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

Saisissez ensuite read -sle nouveau mot de passe et appuyez sur Entrée ; la saisie reste masquée. L' -Eoption demande à sudo de préserver l'environnement, mais la politique sudo locale peut restreindre ce comportement. Si la commande indique que le fichier OC_PASSest manquant ou vide, utilisez plutôt la réinitialisation interactive ou suivez la procédure de gestion des secrets de votre système. Ne désactivez pas les protections sudo uniquement pour faire fonctionner un script.

Étape 4 : Vérifier que le compte peut se connecter

Ouvrez votre URL Nextcloud habituelle dans une fenêtre de navigation privée ou déconnectez-vous de la session en cours, puis connectez-vous avec le même identifiant et le nouveau mot de passe. Une connexion réussie confirme que les identifiants fonctionnent via l'application web, et pas seulement que la commande CLI a été exécutée. Si votre organisation utilise une authentification à deux facteurs, veuillez également effectuer cette vérification.

Problèmes courants et comment y répondre

• Could not open input file: occou une erreur de fichier manquant : vous êtes probablement dans le mauvais répertoire ou utilisez un chemin d’accès incorrect. Localisez le occfichier installé et relancez la commande à cet emplacement.
• Erreurs d'autorisation ou de propriété : vérifiez le compte serveur web/PHP de votre distribution et exécutez la commande avec ce compte. Ne modifiez pas la propriété de manière récursive pour résoudre rapidement le problème ; cela pourrait engendrer des problèmes d'accès plus importants.
• Si le message « Utilisateur inexistant » ou une erreur similaire s’affiche : vérifiez l’identifiant du compte, en respectant la casse. N’indiquez pas d’adresse e-mail à moins qu’il ne s’agisse bien de l’identifiant du compte.
• phpSi la version de PHP sélectionnée est manquante ou incorrecte, utilisez l'interface de ligne de commande PHP (PHP CLI) compatible avec votre installation Nextcloud et votre plateforme d'hébergement. Un serveur peut héberger plusieurs installations PHP ; par conséquent, ne présumez pas que la commande par défaut corresponde à l'environnement d'exécution web.
• Le serveur s'exécute dans Docker, Nextcloud AIO, Snap ou sur une appliance : exécutez-le occdans l'environnement d'application et suivez la procédure de commande officielle de ce déploiement. Le chemin d'accès à l'hôte, le nom du conteneur et l'utilisateur d'exécution diffèrent ; une commande au niveau de l'hôte copiée depuis une installation source peut cibler le mauvais système de fichiers.
• Le compte est géré par LDAP ou Active Directory : ces systèmes font autorité en matière d’identifiants de compte. Une réinitialisation locale du mot de passe Nextcloud peut ne pas mettre à jour un mot de passe géré en externe. Suivez la procédure de réinitialisation de l’administrateur d’annuaire et vérifiez la configuration de votre fournisseur d’identité.
• Vous n'avez pas accès au shell : essayez le lien de réinitialisation du mot de passe de la page de connexion si le compte possède une adresse e-mail valide enregistrée dans Nextcloud, ou demandez à un autre administrateur Nextcloud ou à votre fournisseur d'hébergement de le réinitialiser.

Que faut-il éviter après la convalescence ?

Ne modifiez pas directement la base de données Nextcloud pour remplacer le hachage d'un mot de passe. Ne changez pas le mot de passe du système d'exploitation en espérant réinitialiser un utilisateur Nextcloud. Conservez le nouveau mot de passe confidentiel, supprimez tout secret temporaire de l'environnement shell et stockez-le dans votre gestionnaire de mots de passe. Si vous soupçonnez que les anciens identifiants ont été compromis, vérifiez l'accès via la procédure de sécurité habituelle de votre organisation.

Références officielles

Nextcloud documente les options de récupération et la procédure en cas de mot de passe administrateur oublié dans la section « Réinitialisation d'un mot de passe administrateur oublié » . La commande prise en charge, les invites de mot de passe et l'option de variable d'environnement sont décrites dans les sections « Commandes utilisateur et groupe » et « Utilisation de la commande occ » .