Skip to content
On this page


To add or remove user accounts that can be used to log in to Dashboard, to obtain API keys that can be used to authenticate to create script calls to the HTTP API, and to modify the theme and language of Dashboard, you can use the System module to do so.


Click System -> Users to enter the Users page. The user page displays a list of all current users who can log in to Dashboard, including users created using CLI. Click on the + Create button in the top right corner of the page to open the Create User pop-up box, fill in the user information and click on the Create button to submit the data. Users that are successfully submitted will be added to the list of users. Users that are successfully added can have their passwords changed or their notes changed on the page; users that are no longer required can be deleted on the page.


All users have admin rights to delete other users, but you cannot delete the currently logged in user on the Dashboard. For security reasons, starting with EMQX 5.0.0, Dashboard user cannot be used for REST API authentication.


Click on API Keys under the System menu on the left to go to the API Keys page. If you need an API key to create some scripts to call the HTTP API, you can create and obtain one from this page. Click the + Create button on the top right corner of the page to open the Create API key pop-up box, fill in the API key related data, if the Expire At is not filled in the API key will never expire, click Confirm to submit the data, the API Key and Secret Key of the API key created will be provided on the page after successful submission, where the Secret Key will not be shown later. The user needs to save the API Key and Secret Key to a safe place immediately; when finished saving the data, click the Close button to close the pop-up box.


Click on the API key name to view the key details; click on the Edit button to reset the expiration time, enable status and notes of the API key, and extend the availability of the API key here if it has expired. If an API key is no longer needed, you can delete it by clicking the Remove button on the right side of the API key.



Click on License under the System menu on the left to access the License page. On this page, you can view the basic information of your current License, including the License connection quota usage, EMQX version, customer, and issue information. Click Update License to upload your License Key. In the License Settings section, you can set the high and low watermark limits for the license connection quota usage.



The Settings can be accessed by clicking the setting icon on the top right corner of the page. You can change the language and theme color of the Dashboard, the theme color can be selected if you want to synchronize the OS theme, if this is enabled, the Dashboard theme will be automatically synchronized with the user's OS theme and cannot be selected manually.