Hub 2018.3 Help

Reset Default Admin Account

When you install Hub for the first time, you set the login and password for the default administrator account. This account is assigned the System Admin role in the Global project.

If you forget the credentials for the default administrator account, or have inherited an installation that was configured by another administrator, you can reset the login and password for the account to their default values. You can also set the system properties for the default administrator when you restore the account.

You can also use this procedure when two-factor authentication is enabled and the default administrator no longer has access to the authentication app that is paired with the account. Resetting the default administrator account to its default state also disables two-factor authentication.

If you run Hub in a docker container, use the following procedure.

To reset the default administrator account credentials:

  1. Stop Hub with the command:

    docker exec <Hub docker container ID> stop

  2. Run the configure-next-start command:
    docker run --rm -it -v <path to conf directory>:/opt/hub/conf \ jetbrains/hub:<version> \ configure-next-start \ --J-Djetbrains.hub.admin.restore=true

    Make sure to enter two dashes before the J option. This method sets the system property for the current run only and does not update the configuration file. The administrator account credentials are not reset for subsequent restarts of the Hub service.

    If you want to set any of the system properties for the default administrator account, add them to the command. For a list of system properties, see System Properties for the Default Admin Account.

  3. Run docker container:
    docker container start <Hub docker container ID>
    • The Hub service starts using the specified setting.

    • The default administrator credentials are reset to their default values or the values that are specified in the command.

  4. Log into Hub with the default administrator account.

  5. If required, change the password for the account.

Last modified: 17 December 2018