Skip to main content

Reset NineData Community Edition Administrator Password

Overview

If you forget the NineData Community Edition administrator password, set a temporary password to access the console and create a new administrator password. You must then remove the temporary password and restart the NineData service to complete the reset.

Before you begin

  • The NineData service container is running normally.

  • The NineData Community Edition version is at least 4.1.0. To view the current version, sign in to the NineData Community Edition console and check the upper-left corner of the page.

    version

Procedure

Complete Step 3

Do not stop after setting the new administrator password. The temporary password can still be used to sign in, and the administrator continues to receive password change prompts. The reset is complete only after you remove the temporary password and restart the NineData service.

StageActionReset status afterward
Step 1Configure a temporary passwordNot complete
Step 2Sign in with the temporary password and set a new administrator passwordStill not complete
Step 3 (required)Remove the temporary password and restart the NineData serviceComplete

Step 1: Configure a temporary password

  1. At the terminal interface of the NineData Community Edition server, enter the following command to enter the niup tool interactive interface.

    docker exec -it ninedata niup
  2. Inject a temporary password.

    image-20250509112239465

    console config put admin.login.password <Password>
    tip

    Replace <Password> with the temporary password you want to set.

  3. Apply the temporary password change, and NineData service will restart after execution.

    console restart

Step 2: Sign in with the temporary password and set a new administrator password

  1. Access the NineData Community Edition console and log in with the temporary password from Step 1.

    image-20250508153456552

  2. NineData starts the password change process. In the dialog, enter a new password, complete the confirmation, and then click OK.

Step 3: Remove the temporary password and restart the NineData service (required)

After setting the new administrator password, the reset is not yet complete. Return to the NineData Community Edition server and remove the temporary password immediately.

  1. At the terminal interface of the NineData Community Edition server, enter the following command to enter the niup tool interactive interface.

    docker exec -it ninedata niup
  2. Delete the temporary password.

    image-20250509112330870

    console config remove admin.login.password
  3. Apply the change, and NineData service will restart after execution.

    console restart

Result

The temporary password is removed, and the NineData service restarts. The administrator can now sign in with the new password and no longer receives password change prompts caused by the temporary password.

Appendix: Command reference

OperationCommandExecution Environment
Enter niup tooldocker exec -it ninedata niupHost Machine Shell
Set temporary passwordconsole config put admin.login.passwordniup Interactive Interface
Remove temporary passwordconsole config remove admin.login.passwordniup Interactive Interface
Restart NineData Serviceconsole restartniup Interactive Interface