Skip to main content

Étapes pour réinitialiser le mot de passe administrateur de Portainer

Prérequis​

  1. Ouvrez le terminal SSH de votre TNAS.
  2. Assurez-vous que Portainer a été arrêté dans le Centre d'applications TNAS (doit être arrêté, sinon le fichier de base de données est verrouillé et la réinitialisation échouera).

Étapes​

1. Localisez votre répertoire de données Portainer​

Tout d'abord, trouvez le dossier de données Portainer qui contient portainer.db.

Exécutez la commande suivante :

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

Après exécution, vous verrez une sortie similaire à :

/Volume1/@apps/Portainer/portainer.db

Notez le préfixe du chemin /Volume1/@apps/Portainer – c'est votre répertoire de données.

2. Exécutez la commande de réinitialisation officielle​

Remplacez /path/to/portainer dans la commande ci-dessous par le chemin du répertoire de données que vous avez trouvé à l'étape précédente, puis copiez et exécutez-la dans le terminal :

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

Par exemple :

Si votre répertoire de données est /Volume1/@apps/Portainer, la commande complète est :

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

3. Obtenez le nouveau mot de passe​

Après avoir exécuté la commande, le terminal affichera quelque chose comme :

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!@#$
  • La première ligne indique une réinitialisation réussie.
  • Le aBcD1234!@#$ de la deuxième ligne est le nouveau mot de passe temporaire – copiez-le !

4. Démarrez Portainer et connectez-vous​

  1. Revenez au Centre d'applications TNAS et redémarrez Portainer.
  2. Ouvrez la page web de Portainer (adresse par défaut : http://votre_IP_TNAS:9000).
  3. Saisissez admin comme nom d'utilisateur, collez le mot de passe temporaire que vous avez copié à l'étape précédente, et vous pourrez vous connecter.

5. (Fortement recommandé) Changez immédiatement le mot de passe après la connexion​

  1. Après vous être connecté à Portainer, cliquez sur l'avatar de l'utilisateur dans le coin supérieur droit.
  2. Sélectionnez My Account → Change Password.
  3. Saisissez le mot de passe temporaire, définissez votre propre nouveau mot de passe, puis enregistrez.

Foire aux questions​

1. Pourquoi dois-je d'abord arrêter Portainer ?​

Parce que Portainer verrouille le fichier portainer.db lorsqu'il fonctionne ; l'outil de réinitialisation ne peut pas le modifier. Une fois arrêté, le fichier est libéré et la réinitialisation peut réussir.

2. Mes utilisateurs et configurations créés précédemment seront-ils perdus après la réinitialisation ?​

Cette opération réinitialise uniquement le mot de passe du compte administrateur. Elle ne supprime ni ne modifie les autres utilisateurs, les environnements d'exécution, les fichiers modèles ou les paramètres de configuration du système.

3. La commande renvoie docker: command not found ?​

Cela signifie que le moteur Docker n'est pas activé sur votre TNAS. Rendez-vous dans le Centre d'applications TNAS, installez et activez Docker Engine, puis réexécutez la commande.

4. Aucune sortie de mot de passe après l'exécution de la commande ?​

  • Vérifiez si le chemin du répertoire de données est correct.
  • Confirmez que Portainer est complètement arrêté.
  • Réexécutez la commande.