Skip to content

Dashboard User Management

EMQX Edge 1.4.0 introduces a built-in user management page in the Dashboard. This allows you to control who can log into the Dashboard itself by creating and managing multiple login accounts directly from the UI. Passwords are stored in encrypted form. Plain-text passwords are no longer written to the configuration file.

Manage Dashboard Users

In the left navigation bar, click Users. The page lists all existing Dashboard login accounts.

Add a User

  1. Click the Add button in the top-right corner.
  2. In the dialog, enter a Username and Password, then confirm the password.
  3. Click Confirm.

The new account is added to the list and can be used to log into the Dashboard immediately.

Edit a User

Click the edit icon in the Actions column next to the user you want to update. Modify the password as needed, then click Confirm.

Delete a User

Click the delete icon in the Actions column. The account is removed immediately.

Configure via Configuration File

Dashboard user credentials are stored in the http_server section of nanomq.conf. The default account is defined by the top-level username and password fields. Additional accounts added via the Dashboard are stored in the usernames and passwords arrays, where each index position corresponds to one account. Passwords are stored in encrypted form.

hocon
http_server {
  username = "admin"
  password = "<encrypted-password>"
  usernames = ["user1"]
  passwords = ["<encrypted-password>"]
}

Note

Passwords are stored in encrypted form. Use the Dashboard UI to add or update users. Do not write plain-text passwords directly into the configuration file.