Skip to content

Use MQTTX to Test Connection

This article will introduce using MQTTX as an MQTT client testing tool to connect the deployment of EMQX Platform.

MQTTX is a cross-platform MQTT 5.0 client tool open sourced by EMQ, which can run on macOS, Linux and Windows, and supports formatting MQTT payload.

MQTTX simplifies the operation logic of the page with the help of chatting software. The user can quickly create a connection to save and establish multiple connection clients at the same time. It is convenient for the user to quickly test the connection of MQTT/TCPMQTT/TLS, and MQTT/WebSocket Publish / Subscribe functions and other features.


  1. Install MQTTX client tool
  2. Already Create Deployment in EMQX Platform, and the deployment status is running

Before downloading and installing, please visit our website or GitHub to get the latest version information. The latest version helps to improve the using experience. If you are familiar with this project, you can also directly clone MQTTX repository source code, package and use it yourself. During using, if you have any questions, you can go to GitHub issues to post questions and opinions or Fork our project, and submit a revised PR to us, We will carefully review and reply.

Connection Configuration

Broker Information

Get the connection address and port in the Deployment Overview (the following xxxxx represents a random port, the specific port information please refer to the information on the deployment overview page).

  • Dedicated plan address: domain; port: 1883(mqtt), 8083(ws) is enabled by default, you can enable port 8883(mqtts) and 8084(wss) by configuring TLS/SSL
  • BYOC plan address: the domain name specified at deployment time; port: 1883 (mqtt), 8083 (ws), 8883 (mqtts), 8884 (wss)


All deployments of EMQX Platform have user authentication enabled, so when using MQTTX to test the connection, you need to fill in the Username and Password fields.

Set the Username and Password in Access Control > Authentication, which can be added one by one, or can be imported at once


  • Connect to deployment with MQTT protocol

MQTTX uses MQTT protocol

  • Connect to the deployment with the WebSocket protocol

MQTTX uses WS protocol

  • Connect to deployment with MQTT over TLS/SSL protocol

MQTTX uses MQTTS protocol

  • Connect to deployment with WebSocket over TLS/SSL protocol

MQTTX uses WSS protocol

Name & Client ID

The name is an identification of this connection, the client ID has been filled in by default, and you can click the refresh icon on the right to refresh. After filling in the appeal information correctly, click the connect button in the upper right corner to connect to the EMQX Platform deployment.