HiveMQ Web UI

The HiveMQ Enterprise MQTT broker is able to handle millions of concurrently connected MQTT clients and a throughput of millions of messages per second sent and received by those clients.[1]
This massive load in terms of both clients as well as messages can be challenging to manage and monitor. To address this, HiveMQ contains a specialized Web UI, which simplifies the process of the day-to-day operations of small and large MQTT deployments, by providing all the tools needed to quickly and easily get all necessary insights.

With the HiveMQ Web UI for advanced analysis and administrative tasks, administrators are able to drill down on specific client information and can perform administrative actions like disconnecting a client.
Advanced analytics functionality allows identifying clients with irregular behavior.
For example it is convenient to identify clients that drop messages as the HiveMQ Web UI shows detailed statistics of such misbehaving MQTT participants. Consistent with existing HiveMQ principles the Web UI is designed to scale to millions of concurrently connected MQTT clients.

This guide provides an overview of both configuration and detailed usage explanations for the HiveMQ Web UI.

Despite providing a wide range of information, the dashboard is not designed to replace a full monitoring solution. There are better fitting solutions for this purpose and we recommend running a full-blown monitoring system in conjunction with HiveMQ. Ready-to-use plugins for popular monitoring solutions are available as off-the-shelf plugins.

This document is focused on the features of HiveMQ’s administrative HiveMQ Web UI. If you are looking for general documentation on HiveMQ and all its features, please refer to the HiveMQ User Guide instead.

Getting started

The HiveMQ Web UI is shipped with HiveMQ and enabled by default. No additional installation is needed.


Enabling the HiveMQ Web UI

By default the HiveMQ Web UI is enabled. To disable it, set the <enabled> option to false.

Enable the HiveMQ Web UI
<?xml version="1.0"?>
<hivemq xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:noNamespaceSchemaLocation="../../hivemq-config.xsd">
    ...
    <web-ui>
        <enabled>true</enabled>
    </web-ui>
    ...
</hivemq>


Accessing the HiveMQ Web UI

The HiveMQ Web UI is a web application, which can be accessed from your browser. No additional software needs to be installed on the computer, which uses the HiveMQ Web UI. The HiveMQ Web UI is already included in the standard HiveMQ distribution.

If a HiveMQ instance is already running on your local machine, the HiveMQ Web UI will be enabled by default and you can reach it by navigating to the URL http://localhost:8080/.

The default login is the username admin with the password hivemq

Your HiveMQ Web UI URL might be different, depending on your specific HiveMQ setup. The HiveMQ Web UI can also be configured to be available via HTTPS. For your specific connection details please consult with your HiveMQ administrator.

For security reasons the HiveMQ Web UI only listens on the local network interface per default. To access the HiveMQ Web UI from another computer the default configuration has to be modified.

All the available configuration options can be found in the Access Control chapter.