docs: add password reset guide for v5.x+ web UI lockout#775
docs: add password reset guide for v5.x+ web UI lockout#775mrjacobarussell wants to merge 1 commit into
Conversation
mbentley
left a comment
mbentley
left a comment
There was a problem hiding this comment.
Just looking for some more details and understanding on if this has been tested to work on 6.x as well since there is a big MongoDB version jump between the 5.x and 6.x versions.
|
|
||
| ## The Problem | ||
|
|
||
| Standard password reset instructions (targeting `db.user` with SHA-1) **fail on v5.x+**. |
There was a problem hiding this comment.
Just curious, what "standard instructions" are you referring to here? If an official TP-Link doc/KB, it would be ideal to link to it for reference.
|
|
||
| --- | ||
|
|
||
| ## Step 2 — Get a Legacy MongoDB Shell |
There was a problem hiding this comment.
Given that we have two different versions of MongoDB between the 5.x and 6.x versions, we should make sure we are very clear about what version works with what. I am not currently in a spot where I can test to see if this works for both the 5.x and 6.x versions but I see that your instructions call out 5.x+. I just would like to make sure that it actually does indeed work for 6.x as well and call out that compatibility if it works or not.
2 participants
Summary
Adds
PASSWORD_RESET.mddocumenting how to recover admin access when locked out of the Omada web UI on v5.x+.Problem with existing instructions: Standard reset docs targeting
db.userwith SHA-1 fail on v5.x+. Modern versions store credentials indb.iam_userusing Apache Shiro SHA-256, and the username field is Base64-encrypted.What this adds:
mongosh1.10.6 binary (required — modern mongosh v2.x+ is rejected by the bundled MongoDB engine)iam_usernotuser)Tested on: Omada
5.15.24.19viambentley/omada-controlleron Unraid (2026-06-06)Test plan