Skip to content

Connect with MQTT.fx

This article will take MQTT.fx as MQTT client test tool to connect the deployment of EMQX Platform.

MQTT.fx is the most popular MQTT desktop client tool currently. The major version of MQTT.fx 1.0 is developed by Jens Deters using JavaFX technology, which is a Java virtual machine application. Unfortunately, the maintenance of MQTT.fx has now stopped maintenance and Softblade company has sponsored the development and released its commercial version MQTT.fx® 5.0, which is operated with a fee-based license. MQTT.fx in this article refers to version 1.0 without special instructions.

TCP and TLS protocols are supported but WebSocket.


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

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 the EMQX Platform have user authentication enabled, so when using MQTT.fx 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.


  1. Open connection profile

    Open connection profile of MQTT.fx

  2. Create a new connection configuration and fill in the relevant configuration

    Connection configuration of MQTT.fx

  3. Connect to MQTT broker

    Use MQTT.fx to connect MQTT broker


For more subscription, publishing and other functions, please refer to: Using MQTT.fx to connect to EMQX Platform.