Skip to main content

Reset NineData Community Edition Administrator Password

If the NineData Community Edition administrator password is forgotten, an operator with container management permissions can set a temporary password, use it to change the administrator password, and then remove the temporary credential.

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

Resetting the administrator password requires three steps: configure a temporary password, log in with the temporary password and change the password, and then delete the temporary password.

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: Log in with the Temporary Password and Change the 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 (Important): Remove the Temporary Password

After the password reset is finished, remove the temporary password promptly. Otherwise, the temporary password remains valid for login, and the administrator continues to receive password change prompts.

  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 administrator password is reset, the temporary password is removed, and the NineData Community Edition service restarts with the updated credential state.

Appendix: Command Reference Table

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