Cannot login to admin portal
How do you recover Admin Portal access when the admin username is unknown?
If you cannot log in to the FileCloud Server Admin Portal because the admin username was changed to an unknown value — for example, after the original administrator has left the organization — use the MongoDB Shell to retrieve the current admin username directly from the database, then complete the standard password reset procedure.
Environment:
- Product - FileCloud Server
- Version - Any
- Platform - Any
Why does this issue occur?
The Admin Portal admin username was changed to an unknown value. Without knowing the current username, the standard Admin Portal password reset process cannot be initiated, blocking all administrative access.
How do you retrieve the admin username using the MongoDB Shell?
If access to the Admin Portal is not possible and the admin username cannot be recovered through normal means, use the MongoDB Shell to query the current admin username value stored in the FileCloud database. Follow the steps below in the exact order listed.
- Connect to the FileCloud Server host (via RDP on Windows, SSH on Linux, or direct console access).
- Launch the MongoDB Shell from the MongoDB binary directory on your server. The default path on Windows installations using XAMPP is
C:\xampp\mongodb\bin, but this may vary depending on your FileCloud version and installation method. Use the appropriate executable for your installed MongoDB version:mongo.exe— for older versions of MongoDB (before 6.0)mongosh.exe— for MongoDB 6.0 and later
mongoormongoshdepending on your installed version. - Run the following commands:
use tonidosettings db.sites.find({ "settings.name": "TONIDOCLOUD_ADMIN_USER" }, { "settings.$": 1 }).pretty()
The query should return output similar to the following. The value field displays the current admin username (in this example, admin):
[
{
_id: ObjectId("64b03e74f305487056027512"),
settings: [ { name: 'TONIDOCLOUD_ADMIN_USER', value: 'admin' } ]
}
]
What should you do after retrieving the admin username?
Once you have identified the admin username from the query output, reset the admin password using the following steps:
- Open a web browser and navigate to your FileCloud Server URL appended with
/admin. - On the Admin Portal login page, click Forgot Password.
- Enter the admin username retrieved from the database query and follow the on-screen prompts to set a new password.
- Log in to the Admin Portal using the recovered admin username and the newly set password.
What if the query returns no results or the issue persists?
If the query returns no results or access cannot be restored after completing the password reset, contact FileCloud Support for further assistance.