Skip to content

Manage EMQX Clusters

EMQX Clusters

In ECP, clusters refer to the EMQX clusters deployed on cloud servers, which serve as high-performance message broker for IoT devices. Built on the MQTT protocol, EMQX offers a lightweight, reliable, and scalable solution for communication between IoT devices. It excels in real-time, high availability, and easy implementation. For a comprehensive understanding of EMQX, please refer to the detailed documentation available on EMQX Enterprise.

With ECP's cluster management features, users can efficiently handle multiple clusters, create new ones, onboard existing ones, and perform various tasks like troubleshooting, scaling, modifying network types, adjusting connections, upgrading/downgrading, transferring ownership, and deletion. The platform's user-friendly interface offers cluster information overview and log access for improved visibility.

Access Cluster Workspace

After logging in, you can find the Workspace option in the ribbon area. Click on it to navigate to the Workspace - Cluster page. This page provides an overview of the EMQX clusters hosted or managed by ECP and displays this project's current number of members.


System admin, organization admin, project admin, and regular users all can access this page, however, regular users do not have access to the administration page, and the Workspace - Cluster page serves as their landing page.

For the permission of each role, see Permissions and Roles.


System admin, organization admin, and project admin can create clusters or add an existing cluster to be managed by ECP. For details on how to add clusters, see Add Clusters.

After clusters are added, they will appear in the Cluster List panel, you can choose to view them in cards (default) or as lists. For a detailed explanation of these cluster details, see View EMQX Cluster Details.